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SECTION I 
INTRODUCTION 


1.1 GENERAL 


DX980 is a general purpose operating system which supports the Texas Instru- 
ments Model 980 series computers in a variety of applications. Since a par- 
ticular installation does not generally require all of the applications support 
provided by DX980, the capability to tailor the operating system to an indi- 
vidual installation's needs has been provided. The DX980 General Purpose 
Operating System (GPOS) is modified to a user's requirements through the 
system control console when the operating system is loaded into the computer 
for execution. All other system operations are provided by the operator com- 
munications modules. 


1.2 INSTALLATION 


The installation procedure in Section III is a set of step-by-step instructions 
for installing the DX980 GPOS. The procedure allows the user to install 
DX980 without being familiar with the details of DX980 system software. 


The procedure starts with initial inspection of the DX980 GPOS software pack- 
age and takes the user through preparation of the disc-resident operating sys- 
tem for use. 


1.3 INITIAL PROGRAM LOADING 


The process of loading and initiating DX980 is referred to as Initial Program 
Load (IPL). This is accomplished by a separate program called the IPL pro- 
cessor. The computer operator interacts with the IPL processor to establish 
key parameters within the operating system. After the interactive portion 

of IPLis complete, the operating system is loaded into memory and control 
transfers from the IPL processor to the operating system. The IPL function 
is then complete and subsequent communications with the operator are ac- 


complished by the operator communications function. 


1.4 OPERATOR COMMUNICATIONS 


The role of operator communications in DX980 depends on the applications 
environment, Operator issued commands must be used to initiate subsys- 
tems; they may also be used to initiate user jobs. In environments with a 

high degree of batch processing, the computer operator is responsible for en- 
suring the availability of required resources (such as volume mounting of 
magnetic tapes and disc cartridges, and maintenance of unit record equipment) 
and is also responsible for controlling the applications programs that run on 
DX980. Operator communications provides the capability to accomplish those 
tasks interactively. Informative messages that communicate system status 
are printed on the control console, The console prints requests that require 
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operator intervention either at the console or at one of the computer peri- 
pherals, The operator may also initiate action to cancel programs that re- 
quest unavailable services or execute incorrectly, He may inform the sys- 
tem that a peripheral has become inoperative or that a previously inoperative 
peripheral has become operative, In addition, several functions are available 
to the operator for monitoring and controlling DX980 activities, 


In an environment where the computer is to run essentially unattended, such 
as monitoring and/or controlling instrumentation in a production environment 
or time sharing where the users have access only to canned programs, the 
system control console can be switched from ''system mode" to "user mode", 
where it becomes another peripheral to an applications program. 


1.5 SOFTWARE ERRORS, EQUIPMENT FAILURES, AND SERVICE 

A number of errors and hardware failures may be corrected by the operator. 
Assistance is also available from Texas Instruments field service offices. 
1.5.1 ERROR AND FAILURE MESSAGES 


The DX980 General Purpose Operating System is designed to notify the oper- 
ator about errors or equipment failures by displaying messages or codes on 
the system control console or the computer front panel. The meanings of er- 
ror and failure codes and corrective procedures are given in Appendixes A 
and B of this manual. 


1.5.2 SERVICE FROM TEXAS INSTRUMENTS 


If service from Texas Instruments is needed to correct problems not de- 
scribed in the 980 series computer documentation, contact a field service 
representative at the nearest TI sales and service office. 


1.6 RELATED PUBLICATIONS 


The following publications provide additional information about the DX980 
General Purpose Operating System and the 980 series computers. 


Description Manual No. 
DX980 General Purpose Operating System 943005-9701 


Programmer's Guide 


DX980 General Purpose Operating System 943015-9701 
System Documentation 


Model 980 Series Computer Programming Card 943000-9701 


Model 980A Computer Maintenance Manual 960699-9701 
System Description 

Model 980B Computer Maintenance Manual 943012-9701 
System Description 

Model 980 Computer Basic System Use and 961961-9710 
Operation 
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SECTION II 
SYSTEM FEATURES 


2.1 GENERAL 


The major features of the DX980 operating system are interrupt-driven de- 
vice handlers, multiprogramming with biased addressing and protected mem- 
ory bounds, and subsystems to support batch and interactive terminal pro- 
cessing. The system's management features include flexible job management 
with complete resource allocation, comprehensive data management, dy- 
namic memory management, and priority scheduling of jobs and of tasks 
within jobs. 

2.2 HARDWARE NEEDED FOR SYSTEM OPERATION 


The operating system nucleus occupies approximately 24, 000 words of main 
memory. Additional system hardware to support the nucleus includes the 
following: 


e Additional memory for support of subsystems, language processors, 
and application programs. 


e Either a moving head disc or a DS330 disc system. 


e <A magnetic tape drive to initially load the disc and provide a means 
to dump the disc contents for reloading. 


e A system control console for system interaction with the user. 


e An interval timer. 


2.3 HARDWARE EXPANSION 


In addition to the hardware for operation of the system, DX980 supports a 
full 64K word memory computer system. The modular construction of the 
system allows easy addition of new peripheral devices and their related ser- 
vice routines. Standard device service routines include support for one or 
more of each of the following peripherals: 


a Single or multiple configuration of cartridge disc drives 
® Large capacity disc drive (IBM 3330 equivalent) 

® Single or multiple configurations of magnetic tape drives 
e Model 733 ASR or Model 733 KSR terminal 

® Model 33 ASR teletypewriter 

® Card reader | 


@ Line printer 
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e Video display terminal 
e Paper tape reader and punch 


e Analog-to-digital and digital-to-analog converters 


2.4 SYSTEM STRUCTURE 


The operating system is divided into a nucleus for executive functions common 
to most operations, and several subsystems that perform specific functions. 
In addition to the nucleus, two subsystem modules are supplied with the 
standard operating system: the Interactive Terminal Subsystem (ITS) and the 
Batch Processing Subsystem (BPS). Figure 2-1 illustrates the relationship 

of these subsystems to the nucleus. Other subsystems may also be added to 
perform functions suited to special applications. The following paragraphs 
describe the characteristics of the standard system components. 


2.4.1 NUCLEUS 


The nucleus is the portion of the operating system that defines the system 
parameters, handles input and output servicing, and provides real time 
reaction to the subsystems. The nucleus is divided into four main parts: the 
system table, the memory resident code, the procedure pool or system over- 
lay area, and a Dynamic System Control Area (DSCA). The real time fea- 
tures of the operating system are integrated into these areas and do not form 
a separate subsystem as do the Interactive Terminal Subsystem and the 
Batch Processing Subsystem. Real time features include rollin and rollout, 
task synchronization supervisor calls, dynamic device allocation, the ability 
to start other jobs via a supervisor call, and a method for controlling file up- 
dating with multiple online users. Most of the code for these features oc- 
cupies main memory only when in direct use and runs in the procedure pool. 


Dx980 
NUCLEUS 


INTERACTIVE 


BATCH 
PROCESSING 


TERMINAL 
SUBSYSTEM SUBSYSTEM 
(ITS) (BPS) 


(A)129477 


Figure 2-1. DX980 General Structure 
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2.4.1.1 SYSTEM TABLE, The System Table describes the operating 
parameters of the system including: system job parameters, system-wide 
control blocks, and pointers to system queues, the DSCA, procedure pool 
and free area. The table is created during system generation. 


2.4.1.2 MEMORY RESIDENT CODE. Memory resident code is that portion 
of the operating system that is always in main memory. This code performs 
the following functions in the DX980 system: interrupt processing, system 
disc device handling, task management, preliminary supervisor call process- 
ing, memory management, overlay management, and commonly used lower 
level system subroutines. 


2.4.1.3 PROCEDURE POOL. The procedure pool is a dynamically allo- 
cated memory area used for system overlays. Approximately 80% of the sys- 
tem routines run inthis area. These routines include: device service rou- 
tines not handled by the memory resident code, job management, file 
management, operator communications, and modules of rollin and rollout. 
The user can select the size of the procedure pool to adapt the amount of 
memory available to the operating speed required. 


2.4.1.4 DYNAMIC SYSTEM CONTROL AREA (DSCA). The DSCA isa 
volatile memory pool that is used by the procedure pool routines. Most of 
these routines are written in reentrant code. The DSCA provides a desig- 
nated work area for each task executing a procedure pool routine. The user 
can select the size of the DSCA. 


2.4.2 INTERACTIVE TERMINAL SUBSYSTEM (ITS) 


The Interactive Terminal Subsystem (ITS) provides simplified concurrent 
communications with several terminals, Included in ITS is the ITS Super- 
visor (ITSUPV). ITSUPV oversees the execution of specific applications, in- 
cluding the Remote Job Entry (RJE) feature, status determination (STATUS) 
and the Interactive File Editor (IFE). ITSUPV manages the terminals, and 
provides LOG ON and LOG OFF functions plus the required housekeeping 
functions for multi-terminal usage. ITSUPV interfaces easily with user writ- 
ten application programs. IFE provides interactive generation and editing of 
disc files containing source text. 


2.4.3 BATCH PROCESSING SUBSYSTEM (BPS) 


The Batch Processing Subsystem (BPS) consists of three data handling sub- 
systems that allow convenient batch input and output for the operating sys- 
tem. The three data handling subsystems are Batch Input Reader (BIR), 
Batch Input Spooler (BIS) and Batch Output Spooler (BOS). 


2.5 INPUT/OUTPUT MANAGEMENT 


User programs running under DX980 select I/O devices with a logical unit 
number (LUN) rather than a physical device number. A statement within 
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the JCL input for the job equates the LUN to a physical device name, while 
a physical device table for the operating system specifies an actual I/O de- 
vice to respond to the physical device name, This arrangement allows the 
logical unit numbers within the user program to remain constant, 


2.6 MEMORY MANAGEMENT 


All of memory that is not occupied by the system job (comprised of the resi- 
dent operating system, system tables, and the procedure pool) is designated 
as a free area, The operating system dynamically allocates this area to sub- 
systems and to user jobs, 
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SECTION III 
INSTALLATION 


3.1 INTRODUCTION 


This section contains a step-by-step procedure for installing the DX980 Gen- 
eral Purpose Operating System (GPOS). The procedure allows the system 
operator to install the operating system prior to understanding the details of 
the system's operation. 


At two places in the procedure, in subsections on the building of Physical 
Device Tables and the editing of the Job Control Language (JCL) source 
templates, references are made to supplementary material. This material 
includes Section IV of this manual (Initial Program Load) and the description 
of the use of Interactive File Editor (IFE) commands in the DX980 General 
Purpose Operating System Programmer's Guide. The operator should be 


familiar with these subjects before starting the installation procedure, 


3.2 NOTATIONAL CONVENTIONS 


Major procedural sequences are described in separate paragraphs. Within 
each sequence, steps are identified by Arabic numbers and substeps by lower 
case letters, Some steps in the procedure are optional or are performed if 
specific conditions exist; these options or conditions are identified in the pro- 
cedure. 


Lower-case letters and words enclosed in angle brackets (< >) represent 
parameters or options that must be substituted for the term shown, These 
parameters or options are supplied by the operator or by the software pro- 
gram. 


A required blank in text typed on an input terminal is indicated by a slashed 
lower case letter b (6). This symbol is not used to indicate optional blanks. 


3.3 OPERATING SYSTEM INSTALLATION PROCEDURE 


The installation procedure includes procedural sequences for inspection of the 
DX980 GPOS package after shipment from Texas Instruments, preparation of 
a disc for loading, placement of the operating system on the disc, and prep- 
aration of the disc-resident operating system for use. 


3.3.1 INITIAL INSPECTION 


Before proceeding with installation, inspect the contents of the DX980 GPOS 
installation package, It should include the following items: 


« A set of DX980 software manuals, which includes this manual and 


the DX980 General Purpose Operating System Programmer's 


Guide, Manual No. 943005-9701. 
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e A reel of magnetic tape (part no, 944140-1303 or 944140- 1304) 
containing a copy of DX980 and its associated data sets and 
utilities. 


e A blank 1200-foot reel of magnetic tape (part no. 973718-0004). 


® Copies of the Diablo Disc Initializer Utility on punched cards 
(part no. 944140-1201) and paper tape (part no. 944140-1101). 


e Copies of the DS330 Disc Initializer Utility on punched cards (part 
no. 944140-1202) and paper tape (part no. 944140-1102). 


e A copy of both disc initialization utilities on a cassette (part no. 
944140-0020). 


® Punched card copies of the Disc Save/Restore Monitor (part no. 
944140- 1203), Disc Restore (part no. 944140-1204), and Disc 
Save (part no. 944140- 1205). 


6 Paper tape copies of the Disc Save/Restore Monitor (part no. 
944140-1103), Disc Restore (part no, 944140-1104), and Disc 
Save (part no, 944140-1105). 


e Cassette copy of the Disc Save/Restore Monitor, Disc Save, and 
Disc Restore (part no, 944140-0021). 


® A card loader (part no. 967120-0001), paper tape loader (part no. 
967121-0001), and an EIA loader (part no. 969768-5101). 


These items are supplied in several media to support additions to the initial 
hardware configuration, 


Contact a field service representative if any parts are damaged or missing. 
Damaged or omitted parts will be replaced. 


3.3.2 HARDWARE PERFORMANCE DEMONSTRATION TESTS 


After the DX980 GPOS has been inspected and found to be complete, the hard- 
ware system must be tested to make sure that it is operating correctly. To 
verify that all system hardware is functioning properly, execute a Perform- 
ance Demonstration Test for each hardware equipment item. Instructions 
for running these tests are included in the hardware manuals shipped with 

the equipment. The minimum hardware configuration required to support 

the DX980 GPOS is as follows: : 


® Model 980A or 980B Computer. The memory size must be 48K 
words or larger, In addition, an interval timer, input/output (I/O) 
bus and DMAC device controllers, and 1/O bus and DMAC expansion 
electronics are required to support the hardware system peripheral 
devices. 


® Disc, either Texas Instruments Model DS330 or Diablo. Each disc 
may have up to three add-on disc drives, 
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e Magnetic Tape Transport. The Texas Instruments Model 979 Mag- 
netic Tape Drive is required to support the DX980 software system. 


e Control Console. A Model 733 ASR Data Terminal dedicated for 
system operator use is required for DX980 system software. 


3.3.3 DISC INITIALIZATION 


The first part of the DX980 GPOS installation procedure, after preliminary 
inspection and testing, is disc initialization, Run the Disc Initializer utility 
to format the disc on which the DX980 GPOS will be stored, Also initialize 
any other disc packs in the system. Disc initialization must also be per- 
formed after executing the disc Performance Demonstration Test (PDT), 
head alignment, or any other operation which may affect the initialization 
format. The procedure is as follows: 


I, Mount a copy of the programs in the appropriate medium on the in- 
put load device, The items to be loaded for different input devices 
and disc types are shown below, These items must be loaded in 
the listed order, 


Input Device Diablo Disc DS330 Disc 

Card Reader Card loader (part no, Card loader (part no. 

967120-0001) 967120-0001) 

Diablo Initializer DS330 Initializer (part 
(part no, 944140- no. 944140- 1202) 
1201) 

High-Speed Paper PT loader (part no, PT loader (part no, 

Tape Reader 967121-0001) 967121-0001) 
Diablo Initializer DS330 Initializer 
(part no, 944140- (part no, 944140- 
1101) 1102) 

33 ASR with EIA loader (part no, ETA loader (part no. 
Communications 969768-5101) 969768- 5101) 
Module Inter- Diablo Initializer DS330 Initializer 
face (part no, 944140- (part no. 944140- 

1101) 1102) 

Cassettes Disc Initializer cas- Disc Initializer cas- 

sette (part no, sette (part no, 


944140-0020), side A 944140-0020) side B 


2. Mount the disc that is to become the system-resident disc on its 
drive. Place this disc drive in the non-write-protected mode. 


3. Turn on and enable the input load device, 


4, Set the MODE switch on the computer front panel to the HALT po- 
sition. 


5. Momentarily press the RESET switch downward. 
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6. Set the data switches (top row) to the number code for the input 
load device, as follows: 


Card Reader 0003 )¢ 
High-Speed Paper Tape Reader 0004), 
33 ASR with Communications Module interface 0006,, 
733 ASR (cassettes) 00061, 


7. Momentarily set the PC switch to the ENTER (up) position to enter 
the device number into the program counter. 


8. Set the MODE switch to the RUN position. 


9. Momentarily set the LOAD switch to the up position. This action 
causes the relocating loader to be loaded into main memory. 


10. When this portion of the loading is complete, the IDLE indicator 
lamp lights. After this occurs, set the data switches to the hexa- 
decimal value of the main memory size and enter this number into 
the E register by momentarily setting the E switch to the ENTER 
(up) position. 


ll. Momentarily set the START switch to the START (down) position. 
Wait for the Disc Initializer to be loaded and the IDLE indicator 
to light. 


12. Momentarily set the M switch to the DISPLAY (down) position to 
display the contents of the M register. The M register value is 
displayed by the data indicator lamps, If the value is 00001¢, the 
load was completed normally; otherwise, load the routine again, 
If the second load is unsuccessful, contact a field service repre- 
sentative. 


3.3.3.1 DIABLO DISC INITIALIZATION, The next part of the disc initiali- 
zation sequence depends on whether the disc is a Diablo or a DS330. If the 
system-resident disc (unit 0) is a Diablo, perform the steps in paragraph 
3.3.3.1 and skip paragraph 3.3.3.2. If the system-resident disc is a 

DS330, skip the remainder of this paragraph and perform the steps in para- 
graph 3.3.3.2. 


Initialize the Diablo disc as follows: 


1. Set the SENSE switches to the device number of the unit containing 
the disc to be initialized, as follows: 


_ Unit No. Switch Settings 
0 All four switches down, . 
I Switch 1 up, others down. 
2 Switch 2 up, others down. 
3 Switch 3 up, others down. 
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Note that DMA channel number 1 is assumed for the Diablo. 


2. Momentarily set the START switch to the START (down) position, 
The IDLE and RUN indicator lamps infrequently light and extinguish 
to indicate that the program is running. The program terminates 
after approximately one minute, At program termination, the 
RUN indicator remains lit. 


3. Set the MODE switch to the HALT position, A diagnosis of the disc 
initialization may now be made by examining the contents of the Pro- 
gram Counter and the A register. 


4, To examine the contents of the Program Counter, momentarily set 
the PC switch to the DISPLAY (down) position, The data indicator 
lamps at the top of the front panel display the Program Counter con- 


tents. The interpretation of the contents is shown in table 3-1. If 
PC indicates that the program terminated abnormally (000346), 
examine the A register to determine the cause. To examine the 
contents of the A register, momentarily set the A switch to the 
DISPLAY (down) position. The data indicator lamps display the A 
register contents. The interpretation of the contents is shown in 
table 3-1. 


Table 3-1, Computer Display Diagnostic Interpretations 
Diablo Disc Initialization 


PGs 0002) ¢ Program terminated normally. 


PC = 0003; ¢ Program terminated abnormally. 


'A= 0000) ¢ Program terminated normally, but some disc tracks 
are bad. To identify which tracks are bad, get the 
address of the bad track list from the E register 
(refer to Model 980A Computer Maintenance Manual: 
System Description, Manual No. 960699-9701, or 
Model 980B Computer Maintenance Manual: System 
Description, Manual No. 943012-9701). The first 
word of the list contains the number of bad tracks. 


A = 0001) ¢ Disc is write-protected. 
A = 0002,¢ Disc is offline. 
A = 0015)6 A device or program failure occurred. This will 


not normally happen. 


A = 001616 Track 0 is bad. 

A = 001716 There are more than 30 bad tracks. 

A = 001816 SENSE switch setting was invalid. 

A= 0019)¢ An interrupt occurred by a device other than the disc 


being initialized. This will not normally happen. 
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3.3.3.2 DS330 DISC INITIALIZATION, The procedural steps in this para- 
graph apply to the DS330 disc only. Initialize the DS330 disc as follows: 


1, Enable the system control console (a 733 ASR Data Terminal). 


2. On the computer front panel, momentarily set the START switch to 
the START (down) position. Query messages are printed out by the 
control console. Reply as instructed in the message by entering 
the DMAC port number and the unit number, The standard for both 
of these parameters is zero, Each entry must be followed by a car- 
riage return. 


3. The program prints out a set of Track Extent information, and asks 
whether the operator wants to proceed with initialization rather than 
cancel the program. Reply by entering YES, then typing a carriage 
return (by pressing the RETURN key). 


4, The program analyzes defects in disc operation and formats the 
disc pack for approximately 30 minutes. The program reports de- 
fects by printing appropriate information out on the control console 
as the defects are found. Note that it is not uncommon for several 
minor defects to be reported. At program termination, END OF 
JOB is printed out on the control console. 


3.3.4 LOADING DX980 TO THE SYSTEM DISC 


If the system is already installed on a Diablo disc pack, proceed to section 
3.3.4.2, otherwise, proceed to section 3.3.4.1 and skip 3.3.4.2. 


3.3.4.1 LOADING FROM MAGNETIC TAPE TO DISC. Run the Disc Restore 
routine to load the DX980 GPOS from magnetic tape to the disc on which it is 
to be stored. Proceed as follows: 


1, Enable the system control console (a 733 ASR Data Terminal), 


2. Place the copy of the programs in the system input device, The pro- 
grams must be ina medium appropriate to the input device. If the 
medium is cassette, either cassette drive on the Model 733 ASR may 
be used, The items to be loaded for different input devices are listed 
below, These items must be loaded in the order listed, 


Input Device Items to Be Loaded 
Card Reader Card loader (part no. 967120-0001) 
Disc Save/Restore Monitor (part no. 944140- 
1203) 


Disc Restore (part no. 944140- 1204) 


High-Speed Paper PT loader (part no. 967121-0001) 
Tape Reader Disc Save/Restore Monitor (part no. 944140- 
1103) 
Disc Restore (part no, 944140-1104) 
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Input Device ~Items:to Be Loaded 


33 ASR with Com- EIA loader (part no. 969768-5101) 
munications Mod- Disc Save/Restore Monitor (part no. 944140-1103) 
ule Interface Disc Restore (part no, 944140-1104) 


Cassettes Disc Save/Restore cassette (part no. 944140- 
0021), side A 


Enable the input load device. 


Mount the magnetic tape containing the DX980 GPOS (part no, 
944140- 1303 for the Diablo disc and 944140- 1304 for the DS330 disc) 
on the tape drive. Ensure that the write ring has been removed, 


Refer to the Model 979 Tape Transport Operators Manual, Part 
Number 216376-9701. 


Ready the tape transport (press RESET, then press LOAD). 


On the computer front panel, set the MODE switch to the HALT po- 
sition. 


Momentarily set the RESET switch to the RESET (down) position, 


Set the data switches to the number code for the input load device, 
as follows: 


Card Reader 000316 
High-Speed Paper Tape Reader 00041¢ 
33 ASR with Communications Module interface 00061¢ 
733 ASR (cassette) 0006), 


Momentarily set the PC switch to the ENTER (up) position, 
Set the MODE switch to the RUN position, 


Momentarily set the LOAD switch to the up position, The input 
load device loads the routine, but stops before reading all of the 
input data. At this point, the relocating loader has been loaded. 


When this portion of the loading is complete, the IDLE indicator 
lamp lights. After this occurs, set the data switches to the hexa- 
decimal value of the main memory size and enter this number into 
the E register by momentarily setting the E switch to the ENTER 
(up) position, 


Momentarily set the START switch to the START (down) position. 
The Disc Save/Restore Monitor will then be loaded. Wait for the 
IDLE indicator to light, 
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Momentarily set the M switch to the DISPLAY position to display 

the contents of the M register. The M register value is displayed 
by the data indicator lamps. If the value is 0000;¢, the load was 

completed normally; otherwise, load the routine again. If the in- 
put medium is punched data cards, make sure that they are in the 
correct order when reloaded. If the second load is unsuccessful, 

contact a field service representative. 


Momentarily set the START switch to the START (down) position, 
Wait until the word READY is typed out by the control console, 


On the control console, type 
//ASSIGN, 5, MTI1. 

followed by a carriage return, 
Type 

//RUN, <mnemonic>. 


where <mnemonic>is one of the following mnemonics for input load 
devices: 


Pk for the high-speed paper tape reader 
TTR for the 33 ASR paper tape reader 


CR for card reader 

CSsl for data terminal with tape cassette (left-hand cassette 
drive) 

CS2 for right-hand cassette drive 


Type a carriage return. The input load device finishes reading the 
input data; i.e., the Disc Restore program. 


The program identifies itself by printing 
RESTORE DISC FROM MAGNETIC TAPE 


The control console now types out a series of messages requiring 
operator response. The first message is 


DO YOU WANT TO SAVE THE BAD TRACK MAP FROM DISC 
INITIALIZATION? (Y/N) 


Enter Y followed by a carriage return. The console now types 
VERIFY TAPE AND DISC AFTER WRITE? (Y/N) 

Enter Y followed by a carriage return, The console now types 
DISC UNIT #(0, 3) = 


Enter 0 (zero) followed by a carriage return. 
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This message is now typed: 


DATA SAVED ON <mm>/<dd>/ceyy> WILL BE RESTORED TO< xxxxxx > 
DISC UNIT #0 


where <mm>/<dd>/<yy> is a calendar date (month, day, and last two 
digits of the year) in numeric format and< xxxxxx>is the type of 
disc, either DIABLO or DS330. 


The control console now prints 


OK TO CONTINUE? 


Respond by entering a carriage return, The disc image from the 
magnetic tape will then be written to the disc and verified, 


When the program has terminated, the control console prints 


RESTORE COMPLETE 
*READY* 


Remove the DX980 GPOS magnetic tape from the tape transport, 


3.3.4.2 LOADING FROM DISC TO DISC. Run the Disc Copy/Verify routine 
to copy the DX980 GPOS from the master disc to the disc on which it is to be 
loaded. Proceed as follows: 


1. 
Z. 


Enable the system control console (a 733 ASR Data Terminal). 


Place the copy of the programs in the system input device. The pro- 
grams must be in a medium appropriate to the input device. If the 
medium is cassette, either cassette drive on the Model 733 ASR 

may be used. The items to be loaded for different input devices are 
listed below. These items must be loaded in the order listed. 


Input Device Items to Be Loaded 
Card Reader Card Loader (part no. 967120-0001) 


Disc Save/Restore Monitor (part no. 
944140-1203) 


Disc Copy/Verify (part no. 944145-1201) 
High-Speed Paper PT loader (part no. 967121-0001) 


Tape Reader Disc Save/Restore Monitor (part no. 
944140-1103) 


Disc Copy/Verify (part no. 944145-1101) 
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33 ASR with Com- EIA Loader (part no. 969758-5101) 
munications Mod- 


as ees Disc Save/Restore Monitor (part no. 


944140-1103) 


Disc Copy/Verify (part no. 944145- 
1101) : 


Cassettes Disc Copy/Verify cassette (part no. 
944145-0020), side A 


Enable the input load device. 

Mount the master disc containing the DX980 GPOS in the disc drive. 
Ensure that the unit is in the write protect mode. 

Ready the disc drive (press RUN). 


On the computer front panel, set the MODE switch to the HALT 
position. 


Momentarily set the RESET switch to the RESET (down) position. 


Set the data switches to the number code for the input load device, 
as follows: 


Card Reader 00035 
High-Speed Paper Tape Reader 0004. 
33 ASR with Communications Module Interface 0006, 
733 ASR (cassette) 0006, 


Momentarily set the PC switch to the ENTER (up) position. 
Set the MODE switch to the RUN position. 


Momentarily set the LOAD switch to the up position. The input 
load device loads the routine, but stops before reading all of the 
input data. At this point, the relocating loader has been loaded. 


When this portion of the loading is complete, the IDLE indicator 
lamp lights. After this occurs, set the data switches to the hexa- 
decimal value of the main memory size and enter this number into 
the E register by momentarily setting the E switch to the ENTER 


(up) position. 

Momentarily set the START switch to the START (down) position. 
The Disc Save/Restore Monitor will then be loaded. Wait-for the 
IDLE indicator to light. 
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Momentarily set the M switch to the DISPLAY position to display 
the contents of the M register. The M register vaiue is displayed 
by the data indicator lamps. If the value is 0000_, the load was 
completed normally; otherwise, load the routine again. If the in- 
put medium is punched data cards, make sure that they are in the 
correct order when reloaded. If the second load is unsuccessful, 
contact a field service representative. 


Momentarily set the START switch to the START (down) position. 
Wait until the word READY is typed out by the control console. 


On the control console, type 
//RUN, <mnemonic>. 


where <mnemonic> is one of the following mnemonics for input load 
devices: 


PTR for the high-speed paper tape reader 

TTR for the 33 ASR paper tape reader 

CR for card reader 

CS$l for data terminal with tape cassette (left-hand cassette drive) 
CS2 for right-hand cassette drive 


Type a carriage return. The input load device finishes reading the 
input data; i.e., the Disc Copy/Verify DDCOPY program. 
The program identifies itself by printing: 

DIABLO TO DIABLO COPY/VERIFY 


A se as Sac tal ~~ 
4A Serics of me 


first message is: 


COPY OR VERIFY (0,1): 


es are printed requiring operator response. The 


gE 


ip) 


Enter a 0 (zero). Follow by a carriage return. 
The program now prints 
MOD. 31 or MOD. 44 (0,1): 


If the disc is a model 31, enter a 0 (zero); enter a 1 (one) if a model 
44, Complete the entry with a carriage return. 


The program now prints 
INPUT CHAN# 


Usually a 1 (one) will be entered, followed by a carriage return. 
Refer to Block Transfer Controller Maintenance Manual, P/N 
240892-9701, to determine if other than a one should be entered. 
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The program now prints 
INPUT UNIT # 

Enter a 0,1,2 or 3 followed by a carriage return. 

If the model 44 was specified, the program will print: 
REMOVABLE OR FIXED PLATTER (0,1): 


Enter a 0 (zero) to specify the removable platter or a 1 (one) for the 
fixed platter, followed by a carriage return. 


The program now prints 
OUTPUT CHAN# 


Usually a 1 (one) will be entered followed by a carriage return. 
Refer to Block Transfer Controller Maintenance Manual, Part Number 
240802-9701, to determine if other than a one should be entered. 


The program now prints 
OUTPUT UNIT # 
Enter a 0, 1, 2 or 3 followed by a carriage return. 
If the Model 44 was specified, the program will print 
REMOVABLE OR FIXED PLATTER (0, 1): 


Enter a 0 (zero) to specify the removable platter or a 1 (one) for the 
fixed platter, followed by a carriage return. 


At the end of the copy phase, the message 
COPY COMPLETE 

will be printed. At the end of the verify phase the message 
VERIFY COMPLETE 


will be printed. Any error messages that occur are self explana- 
tory. All error data is displayed is hexadecimal format. 


Upon completion the message 
*READY* 
will be printed. Remove the DX980 GPOS master from the drive. 
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3.3.5 INITIAL PROGRAM LOAD SEQUENCE 


Although the DX980 GPOS is on disc, Physical Device Tables (PDT's) must 
be added to support the hardware configuration, and the desired Job Control 
Language (JCL) templates must be converted into the object format used by 
DX980 job management. To add the PDT's and convert the JCL templates, 

perform an Initial Program Load (IPL), proceeding as follows: 


ds 


ano mw KR W ND 


10, 
ll. 


12; 


1% 


14, 


Set the MODE switch on the computer front panel to the HALT posi- 
tion. 


Momentarily set the RESET switch to the RESET (down) position. 


Set the data switches (top row of switches ) to 000F 


Momentarily set the PC switch to the ENTER (up) position. 
Set the MODE switch to the RUN position. 


Momentarily set the LOAD switch to the up position. This proce- 
dure initializes all of main memory with IDLE instructions. 


Set the MODE switch to the HALT position. 
Momentarily set the RESET switch to the RESET (down) position. 


If the system-resident disc is a DS330, enter 0007_, into the Pro- 
gram Counter by setting the data switches to this value and memen- 
tarily setting the PC switch to the ENTER (up) position. If the 
system-resident disc is a Diablo, skip this step. 


Set the MODE switch to the RUN ‘position. 


Momentarily set the LOAD switch to the up position. The control 
console prints out 


LM= 


Type a carriage return on the control console by pressing the 
Carriage Return (RETURN) key. The console now prints 


BASE= 


Type an S followed by a carriage return to bring in the base that has 
been saved at system generation time by TI. The console then prints 
a question mark 


2 


In order to determine what minimal device configuration is in the 
saved set, type LUD followed by a carriage return to obtain a 
listing of the saved devices. (The $ symbol denotes a required 
blank. ) 


ep 


Change 1 


3-13 Digital Systems Division 


° 
VO 943004-9701 


15. 


16. 


17. 


18. 


19. 


L06 


21. 


22. 


Change 1 


NOTE 


To this point the Initial Program Load (IPL) sequence 
has prepared the system for addition of new Physical 
Device Tables (PDTs). The IPL ALTER command 
performs this addition. Therefore, refer to Section 

IV of this manual to familiarize yourself with this com- 
mand before continuing with the procedure. 


Examine the listing produced in step 14. If the devices listed are 
sufficient for the system being installed, skip to step 21. 


On the control console keyboard, type 
A 


followed by a carriage return. The console prints out a number of 
messages to which the operator replies as outlined in Section IV of 
this manual. 


The sequence and content of the messages printed by the control 
console depends on the hardware devices and their properties. Make 
sure that hardware parameters are entered accurately when replying 
to console messages and queries. The parameters include the Di- 
rect Memory Access Channel (DMAC) number, the external expander 
number, hardware priority slot, and external register numbers. 


To terminate PDT additions, reply to this console query: 
KEYNAME= 

by typing a carriage return. 

To list all PDT's and verify your entries, enter 

LBD 


on the control console, followed by a carriage return. 


If an error is found in the listing, type 


A 


on the console and correct the error as the PDT modification proce- 
dure is repeated. List the PDT's again to verify the entries. 


When the previous steps are completed and the entries are accurate, 
type 
S 


on the control console, followed by a carriage return, to preserve 
the PDT's. 


Type 
G 


followed by a carriage return. 
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When the query 
DATE & TIME = 


is printed by the console, respond by typing in the date dnd time in 
the format: 


MM/DD/YY, HH:MM:SS 

followed by a carriage return, 

The console responds by printing: 
RUNNING MM/DD/YY, HH:MM:SS 


followed by two carriage returns, After a short delay, it prints 
the following (other messages may precede this message): 


*READY 
When the sequence is complete, the DX980 GPOS is loaded, 


3.3.6 LISTING OF THE HELP FILE 


The DX980 system is provided with a HELP file that should be listed at this 


time. 


This file is used to communicate information on the status of the cur- 


rent system and minor items that were omitted from other forms of docu- 
mentation. List this file by performing the following steps: 


ie 


Se Set 


On the control console keyboard, press the Escape key (ESC). The 
console prints a double slash: 


// 


Type 
JOBbHELPbSYSTEM 
followed by a carriage return, 


Press the ESC key, and after the console prints a double slash, type 


RUN¢HELP 

followed by a carriage return, 

After the JOB is submitted, the HELP file is listed on the system 
console, 


After the JOB terminates, read the listing and perform any opera- 
tions at this time that may be indicated. 


SELECTION AND EDITING OF JOB CONTROL LANGUAGE 
SEQUENCES 


If devices have been added to the minimum configuration, some or all of the 
JCL sequences supplied may require modification, The procedures in this 
and the following paragraphs will normally be completed before the system 
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These procedures are used to select and edit the individual user's 


JCL sequences, modify the system so that the BIS and BOS batch processing 
systems can be used if desired, and create a backup copy of DX980 GPOS, 


Refer to the DX980 General Purpose Operating System Programmer's Guide 


(Part Number 943005-9701) for sample listings of JCL source sequences. 


The following procedure is used to select and edit the individual user's JCL 
sequences and convert the sources to object format Job Control Blocks (JCB's). 
The first part of the procedure is the loading of the Interactive Terminal Sys- 
tem (ITS). 


ds 


On the control console keyboard, press the Escape (ESC) key. The 
console prints a double slash: 


// 
Type 
JOBBLTSBSYSTEM 


followed by a carriage return, This assigns a name and identifier 
to the job, 


Press the ESC key, and after the console prints a double slash, type 
RUNBITSBT 1=SC | 


followed by a carriage return, This loads and initializes ITS, with 
the system control console as the interactive terminal. 


The console prints 


NO, =<n> UID=SYSTEM NAME=ITS SUBMITTED 
USER MODE NO. = <n> UID=SYSTEM NAME=ITS 


where <n>is a number. Type 
LOGONBSYSTEMBb1 


in order to provide a user identifier and an accouting number for 
the software system. ITS is ready for use and the console prints: 


READY 

The next part of the procedure is used to select the JCL source 
templates to be used at the individual user's site. On the control 
console, type 


JOBbEXTRACBSYSTEM 
followed by a carriage return. 
Type 
RUNbYANKBDCON=T ERMIO 


followed by a carriage return. 
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The control console prints out a number of messages and the console 
bell sounds, If an index of the names of the JCL source templates 
on file is desired, type 

- #INDEX 

followed by a carriage return, After the list is printed, type 

. # LIST B<xxxxxx> 


where <xxxxxx> is the name ofa JCL template with which the user 
wishes to work, Typea carriage return, The control console 
prints a listing of the template. A listing of all JCL templates can 
be obtained by typing 


-# LSTALL. 
followed by a carriage return, 


Examine the listing produced in step 7. 


NOTE 
If the JCL template requires modification, skip step 9. 

Repeat step 7 to list any other file for examination, If none of the 
JCL procedures require modification, type 
. #ENDALL 
followed by a carriage return. Skip to step 17, 
If the JCL template requires modification, type 
.#COMPILEB<xxxxxx> 
followed by a carriage return to copy the JCL source to the work 
file for editing, 

NOTE 


Only one JCL source may be copied to the work file 
at any one time, 


When the console bell sounds, type 
.# ENDALL 


followed by a carriage return. Then wait for the terminal to print 
READY (other messages may aiso appear before READY). 
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On the control console, type 
EDIT¢FILE=(1, SYSTEM, JCOWORK) 


followed by a carriage return. The editing procedure makes use of 
IFE commands. For detailed information about these commands, 


refer to the DX980 General Purpose Operating System Programmer's 
Guide, Manual No. 943005-9701. 


NOTE 


This procedure cannot be used to add a new template. 
Refer to manual 943005-9701 for the required proce- 
dure. 


Make the desired changes to the template. 
Type 

STOP 

followed by a carriage return. 


The next part of the procedure builds the JCB from the edited tem- 
plate and updates the JCL source file with the edited template. On 
the console, type 


RUN¢ICLU P#DLST=TERMIO#JDERR=TERMIO 


followed by a carriage return. When the console prints the STRING 
termination message, the new JCB has been built. Any modifications 
to the JCL template are reflected in both the system binary and 
source JCL files. 


To repeat the procedure of template selection, template editing, and 
JCB construction for other TI-supplied templates, perform the in- 
structions in steps 5 through 15 again. 


When all editing of all JCL procedures is complete, type 
LOGOFF 

followed by a carriage return. 

Cancel ITS by pressing CTRL O and then the ESC key and typing 
CANCEL <n> 


and a carriage return, where <n> is the job number of the ITS job 
as displayed in the submitted message in step 4. The console prints 
termination messages. 
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3.3.8 PREPARATION OF BATCH INPUT AND OUTPUT SPOOLER FOR USE 


If the Batch Input Spooler (BIS) and Batch Output Spooler (BOS) routines are 
to be used, perform the procedure in this paragraph, The Initial Program 
Load sequence in paragraph 3,3.5 should already have been performed. 


Proceed as follows: 


1, On the control console keyboard, press the ESC key. The console 
prints 


ie 

Type in 

JOBBINITSPKSYSTEM 

followed by a carriage return, 
2. Press ESC and then type 

RUN@#INIT SP 

followed by a carriage return, 


3. The console prints a submission message followed by a termination 
message, Repeat steps 1 through 13 of the Initial program Load 
sequence in paragraph 3.3.5, followed by steps 4 through 6 below, 


4, On the control console keyboard, type 
LBP 


followed by a carriage return, The console prints out a list of IPL 
parameters, 


5. Look at the reference numbers (<nn; >and<nn?>) of the spool file 
VOL parameters (left column of listing). These numbers represent 
the spool-in and spool-out volumes, respectively, Change the con- 
tents of these parameters to one by typing 


Ché<nn}>=1 
Ch<nnz >=1 


and follow each entry by a carriage return, 
6. The next time the console prints a question mark: 
? 
Reply by typing 
S 


followed by a carriage return to save the new setting. 
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3.3.9 SYSTEM BACKUP 


The completed copy of DX980 should be backed up immediately; in other 
words, a tape or disc copy of the information should be made in order that 
one intact copy is available if the other is accidentally changed. 


For the dual disc configuration proceed to section 3.3.9.2, otherwise pro- 
ceed to section 3.3.9.1 and skip section 3.3.9.2. 


3.3.9.1 SYSTEM BACKUP TO TAPE. The backup procedure is as fol- 
lows: 


1, Load the input device with a copy of the programs on the appropriate 
medium. The items to be loaded for different input devices are 
shown below. These items must be loaded in the order listed. 


Input Device Items to Be Loaded 
Card Reader Card loader (part no. 967120-0001) 
Disc Save/Restore Monitor (part no, 944140- 
1203) 


Disc Save (part no, 944140- 1205) 


High-Speed Paper PT loader (part no, 967121-0001) 
Tape Reader Disc Save/Restore Monitor (part no, 944140- 
1103) 
Disc Save (part no. 944140-1105) 


33 ASR with Com- EIA loader (part no. 969768-5101) 
munications Mod- Disc Save/Restore (part no, 944140-1103) 
ule Interface Disc Save (part no, 944140-1105) 


Cassettes Disc Save/Restore cassette (part no, 
944140-0021), side B 


2. Enable the input load device, 


3, Mount a blank tape (part no. 973718-0004) with write ring inserted 
on the magnetic tape transport, 


4, Ready the tape transport (press RESET, then press LOAD). 


5, Onthe computer front panel, set the MODE switch to the HALT 
position, | 


6, Momentarily set the RESET switch to the RESET (down) position, 


7, set the data switches to the number code for the input load device, 
as follows: 


Card Reader 0003 1¢ 
High-Speed Paper Tape Reader 0004)¢ 
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13. 


14, 


LS, 


16. 


33 ASR with Communications Module interface 0006,¢ 
733 ASR (cassette) 0006164 
Momentarily set the PC switch to the ENTER (up) position, 
Set the MODE switch to the RUN position, 


Momentarily set the LOAD switch to the up position, The input 
load device loads the routine, but stops before reading all of the 
input data. At this point, the relocating loader has been loaded. 


Complete the loading of input data and assignment of peripheral 
devices by performing steps 12 through 17 of paragraph 3.3.4. 


After the load device finishes reading the input data, the control 
console prints out a series of messages, some requiring operator 
response, The first message is printed to identify the program and 
appears as 


SAVE DISC IMAGE ON MAGNETIC TAPE 
The console now prints 
DISC TYPE - DS330/DIABLO - ENTER (0, 1) 


Reply by entering 0 for a DS330 disc or 1 for a Diablo disc. Typea 


carriage return, 

The console now prints 

DISC UNIT # (0, 3) = 

Enter 0 (zero) followed by a carriage return, 
The console now prints 


TOTAL #OF TRACKS TO SAVE = 


If the disc is a Diablo, type a carriage return (this will default to 
406 tracks). If itis a DS330, type 


900 


followed by a carriage return. A carriage return default for the 
DS330 will result in saving all 7809 tracks. The selection of 900 
tracks should be adequate until more files are added. 


This message is now typed: 
VERIFY TAPE AND DISC AFTER WRITE? (Y/N) 


Enter Y followed by a carriage return. 
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17. 


18, 


19. 
20. 
Ede 
22s 


The console now prints 
TODAY'S DATE --MM/DD/YY = 


Reply by typing in the date in numeric form, for example 01/31/75 
for January 31, 1975. The next 48 characters may be used for 
comments that will be presented on future restores from this tape. 
Type a carriage return. The save program copies the contents of 
the disc (i.e., the operating system) on tape and verifies disc and 
tape data. Error messages may be printed by the console; error 
messages and their meanings are described in the Model 980 


Computer Basic System Use and Operation, Manual No. 961961-9710. 


If the program terminates normally, the console prints 
SAVE COMPLETE 

followed by 

*READY* 

Remove the magnetic tape from the tape transport, 
Remove the write ring from the tape reel, 

Label this backup tape and store it ina safe place. 


To return control to the DX980 Operating System, perform the IPL 
procedure described in paragraph 3.3.5, 


3.3.9.2 SYSTEM BACKUP TO DISC. Run the Dise Copy/Verify routine to 
backup the DX980 GPOS disc to the disc on which it is to be stored. Proceed 
as follows: 


1. 
2% 


Enable the system control console (a 733 ASR Data Terminal). 


Place the copy of the programs in the system input device. The 
programs must be in a medium appropriate to the input device. If 
the medium is cassette, either cassette drive on the Model 733 ASR 
may be used. The items to be loaded for different input devices are 
listed below. These items must be loaded in the order listed. 


Input Device Items to Be Loaded 
Card Reader Card Loader (part no. 967120-0001) 


Disc Save/Restore Monitor (part no. 
944140-1203) | 


Disc Copy/Verify (part no. 944145-1201) 
High-Speed Paper PT loader (part no. 967121-0001) 


Tape Reader Disc Save/Restore Monitor (part no. 
944140-1103) 


Disc Copy/Verify (part no. 944145-1101) 


en RL 
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33 ASR with Com- EIA Loader (part no. 969758-5101) 
munications Mod- 


Siete Disc Save/Restore Monitor (part no. 


944140-1103) 


Disc Copy/Verify DDCOPY (part no. 
944145-1101) 


Cassettes Disc Copy/Verify cassette (part no. 
944145-0020), side A 


Enable the input load device. 


Mount the blank disc in the disc drive. Ensure that the unit is not 
in the write protect mode and that the blank disc has been initial- 
ized as described in paragraph 3. 3. 3. 


Ready the disc drive (press RUN), 


On the computer front panel, set the MODE switch to the HALT po- 
sition. 


Momentarily set the RESET switch to the RESET (down) position. 


Set the data switches to the number code for the input load device, 
as follows: 


Card Reader D005 é 
High-Speed Paper Tape Reader 0004. 
33 ASR with Communications Module Interface 0006,, 
733 ASR (cassette) 0006), 


Momentarily set the PC switch to the ENTER (up) position. 
Set the MODE switch to the RUN position. 


Momentarily set the LOAD switch to the up position. The input load 
device loads the routine, but stops before reading all of the input 
data. At this point, the relocating loader has been loaded. 


When this portion of the loading is complete, the IDLE indicator 
lamp lights. After this occurs, set the data switches to the hexa- 
decimal value of the main memory size and enter this number into 
the E register by momentarily setting the E switch to the ENTER 
(up) position. 


Momentarily set the START switch to the START (down) position. 
The Disc Save/Restore Monitor will then be loaded. Wait for the 
IDLE indicator to light. 
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15. 


16. 


Lv. 


13. 


19. 


20. 


Momentarily set the M switch to the DISPLAY position to display 

the contents of the M register. The M register value is displayed 
by the data indicator lamps. If the value is 0000, ,, the load was 

completed normally; otherwise, load the routine again. If the in- 
put medium is punched data cards, make sure that they are in the 
correct order when reloaded. If the second load is unsuccessful, 

contact a field service representative. 


Momentarily set the START switch to the START (down) position. 
Wait until the word READY is typed out by the control console. 
On the control console, type 

//RUN, <mnemonic>. 


where <mnemonic> is one of the following mnemonics for input load 
devices: 


Pik for the high-speed paper tape reader 

TTR for the 33 ASR paper tape reader 

CR for card reader 

CS1 for data terminal with tape cassette (left-hand cassette 
drive) 

CS2 for right-hand cassette drive 


Type a carriage return. The input load device finishes reading the 
input data; i.e., the Disc Copy/Verify DDCOPY program. 


The program identifies itself by printing: 
DIABLO TO DIABLO COPY/VERIFY 


A series of messages are printed requiring operator response. The 
first message is 


COPY OR VERIFY (0, 1): 
Enter a 0 (zero) to copy, followed by a carriage return. 
The program now prints | 
MOD 31 or MOD. 44 (0,1): 


If the disc is a model 31, enter a 0 (zero); enter a 1 (one) if a model 
44. Complete the entry with a carriage return. 


The program now prints 
INPUT CHAN# 


Usually a 1 (one) will be entered, followed by a carriage return. 
Refer to Block Transfer Controller Maintenance Manual, Part Number 
240802-9701 to determine if other than a one should be entered. 
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21. The program now prints 
INPUT UNIT # 
Enter a 0,1,2 or 3 followed by a carriage return. 
22. Ifthe model 44 was specified, the program will print: 
REMOVABLE OR FIXED PLATTER (0,1): 


Enter a 0 (zero) to specify the removable platter or a 1 (one) for the 
fixed platter, followed by a carriage return. 


23. The program now prints 
OUTPUT CHAN# 
Usually a 1 (one) will be entered followed by a carriage return. 
Refer to the Block Transfer Controller Maintenance Manual, 
Part Number 240802-9701, to determine if other than a one 
should be entered. 
24, The program now prints 
OUTPUT UNIT # 
Enter a 0, 1, 2 or 3 followed by a carriage return. 
25. If the model 44 was specified, the program wiil print 
REMOVABLE OR FIXED PLATTER (0,1): 


Enter a 0 (zero) for removable or a 1 (one) the fixed platter, followed 
by a carriage return. 


26. At the end of the copy phase the message 
COPY COMPLETE 
will be printed. At the end of the verify phase the message 
VERIFY COMPLETE 


will be printed. Any error messages that occur are self explana- 
tory. All error data is displayed in hexadecimal format. 


27. Upon completion the message 
*READY* 


will be printed. Remove the backup, label appropriately and store 
in a safe place. 


3.3.10 SYSTEM POWER DOWN PROCEDURE 


When the DX980 Operating System is running, use the following procedure 
to remove power from the system: 


1, Use the STATUS operator communications function described in 
Section VI of this manual to display system status. 
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Cancel all jobs in the system except DX980 by using the CANCEL 
command, 


Use the OF FLINE command to place any non-system discs in off- 
line mode, 


Remove power from all peripheral devices, 


Remove power from the Model 980 Computer. 


BUILDING A NON-SYSTEM DISC 


Perform the following procedure when adding a secondary disc to the DX980 
Operating System: 


1, 


Change 1 


Perform the Disc Initialization procedure described in paragraph 
3.3.3 to initialize the new disc, The secondary disc address must 
be used in place of the system disc address, 


Perform the Initial Program Loading (IPL) procedure to load the 

DX 980 Operating System from the system disc, Use the ALTER 
command described in Section IV of this manual to add the secondary 
disc. 


Use the List Devices (LBD) IPL Command to display the devices 
added. 


When the IPL procedure is complete, place the new disc online by 
using the ONLINE operator communications command, When using 
this command, use the same device name that was specified in the 
ALTER command procedure, 


NOTE 


Before defining files on the new disc, create a User 
File Directory (UFD) for the disc by using the sub- 
system, CATLOG. This subsystem is described in 


Section VIII of the DX980 General Purpose Operating 


System Programmer's Guide, Part Number 
943005-9701. 


Use the CATLOG subsystem to define a UFD for the new disc. When 
the subsystem requests the Disc Volume ID, enter the number from ° 
the ID column for the appropriate disc found in the listing produced 
in step 3. 


When the UFD has been created on the new disc, files may be de- 
fined in the same manner as on the system disc, 
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| SECTION IV 
INITIAL PROGRAM LOAD (IPL) 


4.1 GENERAL 


This section of the manual contains the Initial Program Load (IPL) operating 
procedure that the operator uses to initialize the DX980 operating system. 
The following paragraphs contain information about the Read-Only Memory 
(ROM) bootstrap loader, the DX980 disc-resident system loader and its com- 
mand structure, IPL default parameter selection, IPL substitute parameter 
selection, modification of Physical Device Tables {(PDT's), and date/time 
initialization. 

4.2 ROM BOOTSTRAP 


The IPL program is loaded into 980 computer memory by one of the ROM 
bootstrap loaders, all of which reside permanently in the 980 front panel 
ROM. 


4.2.1 BOOTSTRAP LOADER SELECTION 


If the system-resident disc is a Diablo, the Program Counter address setting 
to evoke the proper bootstrap is 000014; if it is a DS330, the address will be 
000716. 


4,2.2 BOOTSTRAP LOADER INITIATION 


The loader is activated by using the computer front panel switches, as fol- 
lows; 


1. Set the MODE switch to the HALT position. 
2. Momentarily set the RESET switch to the RESET (down) position. 


3. Set the data switches to the address of the selected ROM bootstrap 
loader. 


4, Momentarily set the PC switch to the ENTER (up) position to enter 
the address into the Program Counter. 


5. Set the MODE switch to the RUN position. 
6. Momentarily set the LOAD switch to the up position. 


The IPL processor is loaded and program control is transferred to the start- 
ing address of the IPL processor. 


4,3 DISC-RESIDENT SYSTEM LOADER 


After the transfer of control, IPL displays the following message on the sys- 
tem control console: 


LLMs 
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This is a request to the computer operator to supply the name of a disc file 
where a DX980 Load Module (LM) is stored. Normally there is only one ver- 
sion, called the primary system, of DX980 available at an installation. If 
other versions are created either by Texas Instruments or the customer, 
secondary systems may be selected for loading at this time. The primary 
system is the default, and can be loaded by pressing the carriage return 
(RETURN) key on the console. A secondary system can be selected by sup- 
plying the appropriate user identification (ID) and file name as follows; 


(USERID, FILENAME) 
After user ID and file name are supplied, press the RETURN key to load the 
appropriate secondary system. 
4,4 SELECTION OF BASE SET OF DEFAULT PARAMETERS 


After DX980 is loaded, the IPL processor displays the following message on 
the console: 


BASE= 


This is a request to select the set of default IPL parameters that will be used 
as the base set for this IPL. 


4.4.1 TI DEFAULT PARAMETERS 


Each system load module is generated with a base set of default parameters, 
which may be changed during an IPL sequence. If this set is to be used (or 
later modified) in the present loading of DX980, type a carriage return on the 
console keyboard. 


4.4.2 USER DEFAULT PARAMETERS 


If a user has already adapted DX980 to his needs by modifying the preset 
values, and ''saved'' the new parameter set by the process described in the 
discussion of the SAVE command in paragraph 4.5.7, he should enter 


S 


on the console, followed by a carriage return to select the saved base. 


4,5 COMMANDS 


After either reply to the ''BASEs="' query, the IPL program retrieves the 
appropriate set of default values; it then displays a question mark 


? 
which is the standard IPL prompt message. A prompt message is one that 


notifies the operator that a response is required before the program will 
continue. 
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The question mark is a request to supply parameters as temporary substi- 
tutes for one or more of the defaults in the base set. If the base set is ac- 
ceptable, without modification, the IPL processor can be notified by keying 
in 

G 
followed by a carriage return. 
If the base set requires change, or the operator desires to examine the base 
set, the operator may use the IPL command set to accomplish any examina- 


tion and/or change. Operator functions are provided for listing and querying, 
and for modification of the parameters. 


A typing error may be corrected in the following way. If a carriage return 
has not been entered, press the CTRL and H keys simultaneously, then cor- 
rect the entry (the carriage will skip a line after the correction). If an 
error was entered and the carriage return key was pressed, the message 


ILLEGAL PARAMETER 


is printed, and another prompting question mark is printed. Continue in 
this manner until all errors are corrected. 


The IPL commands are entered on the system control console keyboard. 
This subsection describes each command and provides instructions for using 
it. The command set includes the following: 


® LIST 
r) QUERY 
e CHANGE 


e IN 

® OUT 
@ SAVE 
@ GO 


The following paragraphs describe each of the IPL commands and its use. 
The description of the ALTER command includes a discussion of associated 


subcommands. 


The % symbol indicates a required blank. 


Assel ‘cise 


The three parameters P, S and D indicate numeric parameters, SVC pro- 


ee os es a Sa tee eS 
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cedures, and devices, respectively, The LIST command causes all of the 
specified items to be displayed. 


The LIST command has the following formats: 
LYP 
LS 
L‘’D 
The three parameters in the command formats are used in the following ways: 


e P - Refers to changeable numeric parameters in the operating sys- 
tem. The LIST and QUERY commands together with the change 
command can be used to establish the values of all numeric 
parameters that are changeable during IPL. 


e S- Refers to SVC procedures in the procedure pool which can be 
either permanently resident or made resident only when re- 
quested. The LIST and QUERY commands, in conjunction with 
the IN and OUT commands, can be used to control which modules 
are made permanently resident. 


CAUTION 


SVC #0, 4, 67, 73, 74, 95, and 132 are resident in 
the root segment and should not be referenced by the 
OUT command. This action would attempt to free 
these elements from the system root segment, and 
would cause a system failure. 


® D - Refers to the hardware devices that were incorporated into 
DX980 during the SYSGEN procedure. The LIST and QUERY 
commands, in conjunction with ALTER, canbe used to control 
which devices will be considered for user program allocation. 
Note that devices may be placed on line and off line during sys- 
tem execution by use of the Operator Communication commands. 


Figures 4-1 through 4-3 are sample printouts obtained by entering each of 
these commands on the control console keyboard. The listings are examples 
only and are not necessarily related to the minimum configuration hardware, 


4.5.2 QUERY 
The QUERY command causes only the specified item to be displayed. 


Examples of the format of this command follow: 
QUP=3 


QHS=98 
Q%éD= DEVNAM 
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1 FF 21IfE =3500 
ra TECR SIZE =S000 
3 NHAX JOBE TRING=5 

4 MAX JOB STEPE=15 

5S MAX JOB LUNOS=21 

6 MAH JLE DScrR =S00 
Pi LO &GLLEE LIM=31 

pa HI FOLLEP LIm=n 

3 CLOCK INTEYAL=100 


J SPOOL IN ‘YOL=1 
11 SPOBL In PHY=64 
le ZFOGL BUT YOL=1 
13 EPOOL QUT FHY=64 
14 MSC EXPANDER=1 
5 e OF DEUS ERP=0 
16 IHT EXSPRNIER=1 


i 
— 


Figure 4-1. Sample Listing, Numeric Parameters 


cd ae 
Q=1 t=0 2=0 3=0 4=1 3=0 6=0 7=0 3=0 9= 
£0=0 ii=0 t2=0 13=0 14=9 15=0 te=0 :7=0 ,e=0 295 
2020 ei=0 22-0 23=0 24-0 é5=0 26-0 27=0 23=0 esaG 
20-0 32-0 32=0 3320 34=0 35= 36-0 370 33=0 3929 
40-0 41=0 42=0 435-0) +420 45=0 +6= 47=0 4320 49=0 
30-0 Si-O S2=0 S$3-0 $4=0 35-0 56-0 37=0 33-9 S9=0 
£0=0 6i=0 B2= 63=0 64-0 65=0 6e=0 B72 53=0 ®3=0 
70e0 7ieO 72-0 FE=! P4nl F5Ss0 7é=0 7780 78-0 7950 
30-0 Si-0 82-0 8390 S450 85-0 S680 S720 s8=0 saan 
90-0 «(91-00 SERO 93200 4-00 8S=l 0 96800 SFaQ) 8a aaag 
tod=O 10:=C i0e=0 'N3-0 {04-0 105-0 106-0 107-0 '08=0 to920 
{10-0 i1f=0 t22=0 123-0 tide 125-0 i16-0 i170 11820 tigeg 
12020 t22=0 22-0 23-0 t24"0 t25=0 t26"0 l27=0 1288-0 129-0 
130= 13230 i3e=2 t33"0 tad=0 135-0 136-0 137-0 138-0 139=9 
140205 idi=O i4290 143-0 i44=0 1459=0 i4650 {4780 i480 149=9 
150-0 {5250 15220 153-0 154= 25520 tSe-0 t5rs0 i580 15a=0 
160-0 161-0 i6e=0 163-0 té4= $65=0 166-0 t67=f 16880 169-9 
70-0 i710) if2=0 17320) 1rd 175-0 t7é6e=0 ifr7eaO 178-0 179-0 
{30-0 282-90 i320 83-0 i840 185=0 186-0 187-0 125=0 ie9=9 
130-9 i9f=0 i92=9 193=0 
Figure 4-2. Sample Listings, SVC Procedures 
tL OD 


KEY DEVMAM Il! ENABLED EXTRES EXP e-2LOT DEVICE TYFE 


n4i4 DEVE ooo fooe 
ie Oe. DEUS nooo oases CRT - CM 
HS05 DEUS ooo0 O00R raz - CM 
DMA Hoo. LDIABLD 
TMAC ooo1 TIIAEBLO 
1F1F NEUS oOf00 oo 
DOMAC Hoos 
IMAC onde 
IMAC nue 


IT DIDI UOFF 
UT a O01 
rT KET 1 018 
rt LRIEC1 EEA | 
Dg hIsce onde 
CF CF t HOSS 
LF LP1 ones 
MT MT i OLE 
MT MTe Ho20 
SYITEM DTC = DISC! 
LOGGING TPEYICE = KEY1 
EYSTEM COMSOLE $c 


— 
f 


A SO a 


z~aa 


Figure 4-3. Sample Listing, Peripheral Devices 
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4.5.3 CHANGE 


The CHANGE command changes the value of a parameter. The first number 
identifies the reference number of the parameter defined in the LIST com- 
mand; the second number is the new value. 


An example of the format of this command is: 
CB8 = 5 


Note that the CHANGE command may be applied only to parameters (P), and 
not to SVC's (S) or devices (D). The P, S and D parameters are explained 
in the discussion of the LIST command, paragraph 4.5.1. 


4.5.4 ALTER 


The ALTER command allows the user to add, modify, or delete physical 
device information for the table from which IPL will build the DX980 PDT 
queue. This command makes it possible for the operator to tailor DX980 

to the specific hardware configuration, Figure 4-4 provides examples of the 
use of the ALTER command, 


The format of this command is 


A 


4.5.4.1 TABLE BUILDING ROUTINE. The table building routine is in- 
voked when the operator enters an A on the control console keyboard, fol- 
lowed by a carriage return. The prompt messages (messages that notify 

the operator that a reply is required) are not question marks, but textual 
information that depends on the requested input. Therefore, several sequences 
of subcommands (described in paragraph 4.5.4.4) are possible. 


4.5.4.2 IPL PDT BUILDER PARAMETERS, Inthe IPL parameter list, 
there are three parameters used by the IPL PDT builder routine. These 
parameters must be set with the CHANGE command before the ALTER (A) 
command is used. These parameters are: 


DMAC EXPANDER = A flag indicating whether or not DMAC ex- 
pansion is in the system. If the flag is 0, 
no; if itis 1, yes. 


# of DBUS EXP = The number of external expanders connect- 
ed into the system. A value of 0 indicates 
no external expanders. 


INTERNAL EXP = A flag indicating whether or not internal 
I/O bus expansion is available on the sys- 
tem. If the flag is 0, no; if it is 1, yes. 


The LIST command may be used to display these parameters. 
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Figure 4-4. 


KEYAAME =DT ; 
DISPOZITION DEVICE NAMEN Se 
EWHELE DEVICE ‘ves 7 

TIME OUT IM TELONDS c1-2559= 
DMA DEVIC emo e no 

COMMAND PEBISTER * =6 

DATA FEGIZTER + =06 

EXTERFNAL EXPRNDER «= ¢0-49=f 
EXPANTER =LOT # =5 


FRN-TRE-WLECRT-ATR2S ENTER COs 1s293) 2 


TT7¥-Ch ENTER cle isl 

LET FAGE SIZE IN LIWES ¢1-24) 1 
SVYETEM CONZDLE-evy-noy 

LOG6I Mis DEVICE cyYe-Notd 


EEYNAME =LT 

DIZSPOZITION DEVICE MAMESN FEY 1 
EMRELE DEVICE-«venoy ; 
TIME OUT IN SECONDS «1-e552= 
TMAC DEVICE-«" “No 

COMMAHD RFERIZTER = =5 

DATA FEGLZTERP «= =5 

EXTERPHAL EXPANDER  «ct-4).=0 
CeMPANDER =LOT « =10 
TS0-PRS-S1EC0PT-RER SS ENTER COs leds 3) 
TTT<-CM ENTER ¢Oelol 

SYSTEM COMZOLE- «yy -Non 

LOBAING DEVICE ty-Nov 


KEWNAME =LP 
DISPOZITION DEVICE NAME=D LFe 
KEY NAME = 


KEVNAME =CR 

DIZPOZIF ION DEVICE NAME=F CF 1 
ENABLE DEVICE-«Y-Noy 

TIME GUT IN SECONDS <i-e553= is 
IMAC DEVICE-¢yY-NON 

COMMAND FEGISZER  =>1F 

TATA RPEBISTEP = =21iF 

EXTERNAL EXPANDER «+ «0-4. =0 
EXPANDER =LOT = =4 
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REYHAME = Le 

DISPOSITION TEVICE NAMEHTH CR 
ENMRELE Dew CE-cyeNoy 

TIME DUT IM SECONDS ¢1-2559= 15 
IMAC DEYICE=-<Ye-noH 

COMMAMD FEGTSTER e = :1F 
PUTER ETO TER oa = 5 dF 

ES TERNAL EX RANIIER 9 6 tle-do wn 
ESFPAHUER &LOT «+ =< 


EKEXN AME =LF 

DISPORI TION DEVICE NAMES=H LP 
ENABLE DEVICE-cyend y 

TIME OUT IN SECONDS ¢1-2553=2 15 
DPA BEVICE-cveNoy 

INALD CHRAANEL s=5 


EEVNAME =MT 

DISAQSITION DEVICE NAME=H MTi 
ENRELE DEVICE-<yeNo 

TIME OUF IN =ECONTS 1-255) = 
IMAC DEYICE-cyeno'y 

TMAC CHANNEL #=2 

TAPE DRIVE sco-z2> =0 


EEYNAME =NT 

DIZAOSITION DEVICE NAME=H MTi 
ENABLE DEVICE-«y-Nn>¥ 

TIME WT IN SECONDS «1-2595.= 255 
IMACS DEVICE-eyenay 

EMAC UMANMEL s=2 

TAFE DRIVE weco-2) =n 


EEVYNAME =MT 

DNI=PO21 TION DEVICE NAME=N MTZ 
ENABLE DEMECE-¢Y-Nnon 

TIME OUT IN SECONDS (1-255)= 255 
DMAC DEVE CE-«¥-No 

DMAC CHANNEL *=2 

TAPE DRIVE c¢o-2) =1 


KEYNAME = 


Figure 4-4. Examples of Use, ALTER Commands 
and Subcom mands (Sheet 2 of 2) 
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4.5.4.3 DEVICE INDEX MODIFICATION, If the ALTER command has 
been used to modify any devices referenced by a given JCL template, the 
operator must rerun the JCL translator with that template as input, because 
the device index in the old object format block of the JCL is no longer valid. 


4.5.4.4 ALTER SUBCOMMANDS. Several sequences of subcommands may 
be used with the ALTER command. A complete description of these subcom- 
mands is presented in tables 4-1 and 4-2. Examples of use of the ALTER 
command and subcommands are shown in figure 4-4. In the last example in 
figure 4-4, a carriage return was entered after the last KEYNAME = to ter- 
minate the sequence. After termination, enter 


LD 


followed by a carriage return to display the results. 


Table 4-1. ALTER Subcommands 


KEYNAME 


The two-character keyname is se- 
lected from table 4-2, which lists 
DX980-supported devices. 


DISPOSITION DEVICE NAME 


The disposition is (New), (Replace), 
or (Delete). Enter only the first 
character of the disposition, follow- 
ed by a space, and then the device 
name (6 characters or less). The 
operator may name each device as 
he wishes. 


The New disposition is used for de- 
vices that are not yet on the Physical 
Device Table. To find out what de- 
vices are already onthe table, enter 
the command LD on the control con- 
sole keyboard before entering the A 
command. 


The Replace disposition is used to lo- 
cate a device information table by de- 
vice name. Any of the variables for 
this device name may be changed 
using the Replace function. 


The Delete disposition is used to de- 
lete devices from the table. 
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Table 4-1. ALTER Subcommands (Continued) 


ENABLE DEVICE (Y/N) This reply instructs the PDT build 
routine to put the device on/off line 
initially. 


NOTE 


The system disc, system con- 
sole, and logging device are 
put online unconditionally by 
the IPL processor. 


TIME OUT IN SECONDS (1-255) The amount of time that elapses be- 
fore the device times out. If no time- 
out is desired, enter 255 on the con- 
sole keyboard, followed by a carriage 
return, or enter a carriage return 
only. Typical values for standard 
devices are given in table 4-2. 


DMAC DEVICE (Y/N) Y specifies a DMAC device, Na data 
bus device. 


DMAC Device Subcommand 


DMAC CHANNEL # Number of the slot occupied by the 
DMAC interface card. The message 
WARNING SLOT IS ALREADY 
ASSIGNED 
will be printed by the console if the 
operator attempts to assign the same 
DMAC CHANNEL # to two different 
DMAC controllers. Only the last 
channel assignment specified will be 
valid. . 


Disc Subcommands 


DS330 OR DIABLO ENTER (0,1) | For discs, the disc type (DS330 or 


Diablo) is requested; so are the disc 
pipe UNIT a A022) unit number and whether or not the 
SYSTEM DISC (Y/N) disc is the system-resident disc. 


Tape Drive Subcommand 


TAPE DRIVE # (0-2) For magnetic tapes, the tape unit 
number is requested. 
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Table 4-1, ALTER Subcommands (Continued) 


External register number for 
command/status information about 
I/O data bus devices. 


Subcommand Query 


Data Bus Device Subcommands 


COMMAND REGISTER # 


External register number for data 
transfer to or from I/O data bus de- 
vices. 


EXTERNAL EXPANDER # (0-4) Number of the external I/O data bus 
expander occupied by the I/O inter- 


face card. 


EXPANDER SLOT # Slot number occupied by the card in 
the appropriate expander. The mes- 
| sage 

| **WARNING SLOT IS ALREADY 
| ASSIGNED 
| 


DATA REGISTER # 


will be printed on the console if the | 

operator attempts to build two de- | 

vices with the same expander and 

slot number. The PDT's for both : 

devices will be built, but only the 

last one is valid. 
h 
| 
| 


Data Terminal Subcommands 


730-733-912CRT-ASR33 


——— a7 


For data terminals, the device type 
(730, 733 ASR/KSR, 912, or 33 ASR 
is requested, 


TTY/CM ENTER (0, 1) The device interface card (teletype- 
writer or communications module) is 


requested. 


CRT PAGE SIZE IN LINES (1-24) Number of lines per screen used by 
ITS. Requested for CRT devices 


only. 

SYSTEM CONSOLE - (Y/N) Is this data terminal the system con- 
sole? 

LOGGING DEVICE - (Y/N) Is this terminal the system logging 


device? (I.e., will submission and 
termination messages be printed 
here? ) 
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Table 4-1. ALTER Subcommands (Continued) 


Pape rT ape Subcommand 


DEVICE TYPE TTY/CM/HS For the paper tape reader and paper 

(0, 1, 2) tape punch, three interface types may 
be specified: teletypewriter, com- 
munications module, or high speed. 


Table 4-2 lists standard assignments of command and data registers and 
the expander slot numbers. 


4.5.4.5 HARDWARE PRIORITY AND EXTERNAL REGISTER NUMBER 
CHANGES. The interval timer PDT is always resident in the system table 
area. The hardware priority and external register numbers may be changed 
during the table builder process by entering the keyname 


EE 
and 

RBDUMMY 
4.5.4.6 TERMINATION OF ALTER COMMAND PROCESSING. To termi- 
nate the processing of the ALTER commands, wait for the next KEYNAME = 


prompt from the control console, and enter only a carriage return. A ques- 
tion mark query denotes return to main-line IPL processing. 


Before proceeding further, validate the input by entering L#D followed by a 
carriage return, to obtain a listing of the updated device information. Errors 
are easily made at this point in the procedure; therefore, the listing should be 
checked carefully. . 


4,5.5 IN 
The IN command causes an SVC procedure to be made permanently resident. 
An example of the format of this command follows: 


Ié10 


The IPL processor will bring all those SVC's marked resident into the Pro- 
cedure Pool before passing control to the system. Since the DX980 Procedure 
Pool manager provides optimum use of the Procedure Pool region, it is sug- 
gested that this command be used with discretion. 


Note that the IN and OUT commands apply only to SVC's (S parameter). 
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congole) 


console) 


console) 


console) 


{ Device | Device and Suggested 
Type Interface DEVICE NAME(s} 
Data Terminals 733 ASR DT KEYn or 

(Communica- SC (if system 
tions Module) 
33 ASR DT KEYn or 

| (Communica- SC (if system 

7 tions Module} 
33 ASR DT KEYn or 
(TTY) SC (if system 
733 KSR DT KEYn or 
{Communica- SC (if system 
tions Module) 
912 CRT DT CRTn 

5 


Cassette 


Card Reader 


Paper Tape Reader 


ae se 


Paper Tape Punch 


Data Module 


AD/DA 


Interval Timer 


Line Printers 


Discs 


Magnetic Tape 


Note |: 


Note 2: 


Note 3: 


Change 1 


tions Module) 


730 

(Communica- SC (if system console) 
tions Module) 

Cassettes on cs CSni- Note 13, ‘ 
733 ASR CSn2 

(Communica- 


tions Module) 


Data Products 
(CDR) 


CR 


Remex, High PR 


Speed (PTR) 


33 ASR, Low 
Speed (Com- 


munications | 


PR 


Module) 


33 ASR, Low 
Speed (TTY) 


PR 


Remex, High PP 


Speed (PTP) 


33 ASR, Low 
Speed (Com - 
munications 
Module) 


33 ASR, Low 
Speed (TTY) 


User specified 
(DM) 


PP 


PP PTPn 


DM DMn 


Digital 1/0 and 
Analog Output 
(7430) 

High Level 
Analog Input 
(7460) 

Low Level 
Analog Input 
(7470) 

Wide Range 
Analog Input 
(7480) 


AD ADDAn 


Toterval 
Timer 


IT DUMMY 


Centronics 
(DM) 


LP LPn 


Data Pro- 
ducts (LP) 


Diablo (MHD) 


DS330 
(DM AC) 


979 Magnetic 
Tape (TC) 


LP LPna 


DD 
DD 


DISCo 
DISCn 


MT MTn 


An entry of 255 specifies no timeout. 
A simple carriage return provides the 
same result. 

Unit numbers are set by the mod- 
select plug for the DS330 and by inter- 
nal jumpers for the Diablo disc drive. 
No two device interfaces may use the 
same register number, The ones 


-shown here are standard for the firet 


device of each type, See the Mode} 
980 Computer Assembly Language 
Input/Output Manual (Manual No, 
961961-9734), for standard register 


Gf syste: 
DT KEYn or 


ENABLE 
DEVICE-~(Y 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


Note 6 


f 


AT 
FAN? 


TIMEOUT f 
(Note 1} 


255 


255 


255 


255 


60 


15 


30 


60 


60 


30 


60 


60 


60 


60 


15 


Note 4: 


Note 5: 


DEVICE -(Y¥/N) | CHANNEL # 


DS330 OR 
DM AC DMAC 


(0,1) 


N 


assignments of secondary devices. 
The standard minimum configuration 
has the system console in chassis 
location 103, 

Refers to the Data Bus Expansion 
Chassis number that contains the in- 
terface card for this device. A re- 
aponse of 0 indicates that the inter- 
face resides in the 980 Computer in- 
ternal expansion or that no expansion 
ie available. ‘ 

Indicates the data bus [/O slot num- 
ber that containe the interface card 


DISC UNIT 


DIABLO ENTER{ NUMBER 


{Note 2} 


SYSTEM 
DIsc-ty/Ni 


Note 7 


Note 7 


Note 8 


Note 


Note 


Note 


Note 


5 5 9 
5 5 0 
>A 2 0 
5 5 0 
5 5 0 
I 1 
5 5 0 
5 5 0 
>1F oF 0 
>10 >18 0 
| 5 | 5 0 
| oA 2 0 
| é 
all 218 0 
5 5 0 
oh 2 0 
244 244 0 
o44 244 0 
| 4 | 4 18) 
50 50 0 


for thie device. Slot numbers (XX) 
are indicated on the expansion chassis 
and the 980 main frame as ‘'10XX', 
Device should be enabled only if it ia 
physically available, 

Only one syatem disc may be speci - 
fied. 

Tape unit numbers are determined by 
the order in which they are daisy- 
chained together. Unit 6 is the first 
unit in the chain, etc. 

Only one device may be apecified as 
a system conecle. 


SLOT # 
(Note 5) 


Note 3 


Note 3 


Note 3 


Note 3 


Note 3 


Note 5 
Note 5 


Note 5 


Note 5 


Note 5 


Note 5 


Note § 


Note 5 


Note 5 


Note 5 


Note 5, 
12 


33 ASR ENTER 
(0,1,2, 3) 


ae 


a eS pe ee ee Oe 
ge eB a 


Note 


Note 


Table 4-2. 


DEVICE TY PE-- 


CRT Page Size | SYSTEM | LOGGING 
in Lines (1-24) | CONSOLE | DEVICE 
Note 9 Nete 10 

Note 9 Note 10 

Note 9 Note 10 

Note 9 Note 10 

Note 11 Note 9 Note 10 
Note 9 Note 10 


i0: Only one device may be specified as 


a logging device. 

Refers to CRT's only. Thies variable 
is used by the Interactive Terminal 
System (ITS) and determines the num- 
ber of display lines available. A car- 
riage return will result in a default of 
1 line, or else the number of lines de- 
eired must be entered. The maximum 
value ie 24 lines (a full screen). 


 i2. Assign the Centronics line printer to 


the lowest privrity locatiana, 
ut: The first cassette entered is assumed 
tobe the one on the left side, 


TTY /CM/HS 


--ENTER (0, 1, 


Responses for IPL 


ALTER Command 


4-13/4-14 
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4.5.6 OUT 
The OUT command causes the SVC procedure to be made non-resident. 
An example of the format for this command is: 

O15 


Note that the IN and OUT commands apply only to SVC's (S parameter), If 
the operator attempts to use the OUT command to make an SVC non-resident 
which is in the system root, the command will be ignored. 


4.5.7 SAVE 


The SAVE command causes the configuration to be saved on disc. 


NOTE 


The configuration includes parameters, the SVC 
resident/non-resident table, and the device table. 


The format of this command is: 


S 


S may be entered on the control console keyboard at any time during the com- 
manding process {i.e., in reply to a question mark). The configuration which 


the operator last saves is the one that will be retrieved when the BASE = query 


view 


is answered with an S and a carriage return. Therefore, a SAVE should be 
the last command entered before the GO command. 


4.5.8 GO 


The GO command indicates that all the variables have been set. 
The format of this command is: 


G 


Entering G followed by a carriage return causes the IPL processor to incor- 
porate the base set into the system, and closes the commanding process; 
therefore, the operator must have carried out all modifications, and saved 
them, before this command is entered, 


4.6 DATE AND TIME INITIALIZATION 


After the operator enters the G command, the following request is displayed 
on the console: 


DATE & TIME= 
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The values are set by a single entry, with the following format: 
MM/DD/YY, HH:MM:sSS 


Where hours (HH), minutes (MM) and seconds (SS) represent the elapsed 
time since midnight. The IPL processor echoes the date and time and then 
transfers control to the operating system. From that point on, all system 
communications with the console are carried out by the operator communi- 
cations functions. 


4.7 CONSEQUENCES OF CHANGES 


For some options modifiable by IPL, tradeoffs and interactions exist which 
are not obvious to the operator, but which can have a significant impact on 
system performance. The following discussions explain the important points 
for changes to parameters, supervisor calls (SVC's), and peripheral devices. 


4.7.1 DEFINITIONS OF TERMS 


The operator should understand several terms related to program loading and 
execution; these terms are briefly explained here. 


Rollin and rollout are processes for transferring an entire job partition from 
disc to memory and from memory to disc, respectively, when a program 
must relinquish memory to a higher priority program. The memory being 
used by the lower priority job is copied to disc, after which the higher pri- 
ority job is loaded and serviced by the Central Processor. The lower pri- 
ority job is returned to memory from disc when all jobs of priority sufficient 
to cause rolling have been serviced, and the Central Processor then resumes 
servicing of the lower priority job. 


Spooling is the process of copying information to or from disc. The Proce- 
dure Pool is a file of frequently used procedural routines. 


4.7.2 PARAMETERS 


The Tl-supplied parameter default values are calculated to provide optimum 
system performance in a typical user installation. Individual installations 
may have special requirements which justify modifying the preset values for 
their own needs. Users at these installations may wish to utilize optional 
features, such as ROLLIN/ROLLOUT or spooling, which must be enabled 
during IPL execution. 


A list of parameters modifiable by IPL is given in table 4-3. Their ordering 
may change in different releases; therefore, they should be listed (by entering 
LBP and a carriage return on the control console keyboard) before making 
any modifications. , 


I 
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Table 4-3. Parameters Modifiable by IPL 


Parameter Description 


PP SIZE 
DSCA SIZE 


Procedure Pool size in words. 


Dynamic System Control Area size in words. 


MAX JOB STRING 


The maximum number of jobs that will be al- 
lowed in the system. Used for small memory 
systems. 


MAX JOB STEPS Maximum number of independent job steps al- 


lowed in the system. 


that will be allowed within a single job. 


MAX JSB DSCA The maximum amount of memory in words that 
will be used for storage of the job queue. All 
job step JSB's beyond this amount will be 


stored on disc. 


LO ROLLEE LIM The priority level below which a job may be 


= mat 


| =~! 
LOLiCU VUUble 


MAX JOB LUNOS | The maximum number of logical unit numbers 
| 
| 
| 
| 
| 
i 


HI ROLLER LIM The priority level above which a job may cause 
| rolling. 
CLOCK INTRVAL The interval (in milliseconds) between timer 
interrupts. 


OL The number of the disc 
input spool file. 
SPOOL IN PHY 


SPOOL OUT VOL 


Physical record size of input spool file (in words). 


The number of the disc volume containing the out- 
put spool file. 


oR NN ese Amn ed RB 


SPOOL OUT PHY Physical record size of output spool file (in words) 


| SPOOL LP WIDTH The size of the line printer carriage. 0 implies 
80 columns, 1 implies 132 columns. 


DMAC EXPANDER Denotes the presence (1) or absence (0) of a 
DMAC expander. 


# OF DBUS EXP Number (0 to 4) of external data bus expanders. 


INT EXPANDER Denotes presence or absence of an internal data 


bus expander. 


| 
| 
cae, [Se eee a Siem ~ ns 
volume containing tne . 


Aictecrit dD 
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4.7.2.1 DECREASING PROCEDURE POOL SIZE. One desired modifica- 
tion, especially in installations with limited main memory size, is to increase 
the memory size available to user programs by decreasing space for the 
Procedure Pool. In some cases this is feasible; for example, running with 
one job doing limited I/O, and with infrequent step termination, makes rela- 
tively light demands on the Procedure Pool. However, in most cases, any 
trimming of the Pool will result in substantially slower system-performance. 
A large reduction in the Pool size may cause a system failure. Changes to 
the size must be on a cut-and-try basis; in general, a size cut is not recom- 
mended. 


4.7.2.2 DECREASING DYNAMIC SYSTEM CONTROL AREA SIZE. Similar 
considerations apply to changes in the Dynamic System Control Area (DSCA) 
size. The parameter interacts with the MAX JOBSTRING and MAX JOB 

DSCA parameters; any reductions in DSCA size should be accompanied by 
reductions in the others. DSCA reductions are less likely than are Procedure 
Pool reductions to slow the system performance but are more likely to cause a 
system failure. 


The addition of devices (Physical Device Tables) should be accompanied by in- 
creases to DSCA size. | | | 


4.7.2.3 USE OF ROLLIN/ROLLOUT FACILITY. The preset values of 
the ROLLER and ROLLEE parameters will not enable the ROLLIN/ROLLOUT 
facility, so that the user who desires the facility must manually specify the 
desired priority levels. 


The purpose of the two parameters is to allow three categories of programs 
e Those which cause rolling. 
e Those which can be rolled. 
e Those which can neither roll nor be rolled. 


Specifying a ROLLEE limit of higher priority (or lower priority) number 
than the ROLLER limit may result in a run-time error condition. If this | 
facility is to be used, the operations manager of the installation should ex- 
ercise a set of standards governing program priority specification. 


4.7.2.4 SPECIFICATION OF DISC VOLUMES. If the SPOOL IN VOL and 
SPOOL OUT VOL parameters specify different volumes, the SPINT utility 
program which creates the files must be executed once for each volume. If 
the same volume is specified, the SPOOL OUT PHY and SPOOL IN PHY 
parameters must be identical and must be multiples of 32. 


NOTE 


: ~~ 


The roll file will be allocated only if the roll limits 
are set such that rolling is possible. 
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4.7.3 SUPERVISOR CALLS 


The only operator option available to control DX980's treatment of service 
calls (SVC's) is the IN/OUT function, by which an SVC may be locked into 
the procedure pool regardless of the activity against the SVC. 


Since the Procedure Pool Manager in DX980 has logic to detect the frequency 
of use of a given module, and retain a module in memory on that basis, al- 
most all SVC's are preset to nonresident status. In almost all cases, an in- 
stallation does not gain in system efficiency by causing any of these modules 
to be resident. Therefore, the operator is advised to refrain from using 

the option except in unusual circumstances. 


4.7.4 PERIPHERAL DEVICES 


The discussion of physical devices includes system performance considera- 
tions affecting Physical Device Tables and JCL templates. 


4.7.4.1 PHYSICAL DEVICE TABLES. Since only a rudimentary set of 
PDT's are included in the shipped version of DX980, the user must use the 
ALTER command to create new PDT's as part of the installation procedure. 
Because the PDT's are built in the DSCA, the parameter for DSCA space 
should be increased by 25 words for each new PDT to allow the available 
working space to remain constant. 


4.7.4.2 JCL TEMPLATES. All JCL templates referring to freshly 
ALTERed devices must be reprocessed by the JCL translator. 
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SECTION V 
OPERATION AND STRUCTURE OF 


OPERATOR COMMUNICATIONS PACKAGE 


5.1 GENERAL 


The operator communications package for DX980 exists as a task which runs 

under the system job. The procedures driven by this task consist of a group 

of modules, only one of which is part of the resident system. The remaining 
modules are invoked by supervisor calls and occupy memory in the procedure 
pool as necessary. 


The operator communications task is only active when explicitly requested by 
receipt of an Escape (ESC) character from the system console when in the 
system mode. This task remains active for the time needed to request and 
process a command. It then reenters an inactive state, awaiting an event 
which will activate it again. Once the operator communications task is ac- 
tive, the ESC character is utilized to cancel an input or output record cur- 
rently in progress at the device. This action provides early termination of 
requested displays; e.g., the display of status on all tasks. 


5.2 SYSTEM CONSOLE CHARACTERISTICS 


The following are characteristics of the system console which affect the func- 
tioning of the operator communications task: 


e® LUN 0 of the system job is permanently assigned to the system 
console. 


® LUN 0 is always open and has a maximum record length of 80 
characters. 


e The console has two modes: system and user. The system mode is 
activated by pressing the CTRL and letter O keys simultaneously 
(Control O). The user mode is activated by pressing the CTRL and 
U keys simultaneously (Control U). In the system mode, any output 
to the console from a user job is queued until return to user mode. 
In user mode, however, output from a system job is printed on the 
console immediately, breaking into the user's activity. 


@ All input/output via the system console is performed via LUN 0 
or LUN 1 of the system job. 
5.3 OPERATOR COMMUNICATIONS TASK STRUCTURE 


The structure of the package can be divided into four functional’ components. 
They are the initiator, driver, processor, and diagnostic components, which 
are described in the following paragraphs. 
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5.3.1 INITIATOR 


The initiator is the only resident portion of the package and consists of a sin- 
gle module, which occupies a minimum amount of memory. It provides an 
entry point for execution when the operator communications task is activated, 
initiates execution of the non-resident portion of the package, provides the 
exit point from the non-resident portions, and suspends the operator commu- 
nications task pending re-activation. 


wove DRIVER 


The driver is the module invoked by the initiator. It requests input from the 
console and transfers control to the appropriate module to process the com- 
mand received. It also will invoke a diagnostic function if the command re- 
ceived was syntactically incorrect, or if return from the processing module 
indicated the need to call the diagnostic function. 


5.3.3 PROCESSORS 


At least one processor module exists for each command that is defined. The 
processor module accomplishes the necessary action for the requested com- 
mand, 


5.3.4 DIAGNOSTIC 


A single module provides a common vehicle by which diagnostic messages 
for operator communication are displayed. This module is called from the 
driver module if one of the processor modules called from the driver returns 
a completion code. The following conventions apply to the completion code: 


e Code = 0: Normal termination of processor module. 
® Code 7 0: Signifies request for a diagnostic message. 


The driver module itself uses the diagnostic module if it encounters an er- 
ror in the initial processing of the command. Nonzero codes are printed on 
the console listing. 


5.4 COMMAND LANGUAGE 


The command language utilized by the operator communication package con- 
sists of a command name followed by zero or more operands, whose meaning 
is dependent on the particular command being requested. The command name 
is a label containing 1 to 8 characters, but DX980 responds correctly if only 
the first two letters of the label are entered. 


Delimiters between operands are either a comma, or one or more blanks; 
the commands are terminated with either a period and a carriage return 
(RETURN) or a RETURN alone. If a command with operands is longer than 
a line, the line is terminated with a semicolon and a carriage return. 
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5.4.1 PROMPT CHARACTERS 


The Operating System uses prompt characters to request user input on the 
system console, The two prompt characters are double slash (//) and double 
period (..). When the operator presses the ESC key, the system displays a 
double slash if it recognizes that the new line is also a new command (a new 
command is recognized when the previous line is terminated with a carriage 
return, or with a period and a carriage return), If the new line is a contin- 
uation of the previous command, the system displays a double period for a 
prompt character (a continued command is recognized when the previous line 
is terminated with a semicolon and a carriage return). The operator may not 
enter a command until the prompt character is printed, 


5.4.2 CORRECTIONS TO ENTRIES 


When an error has been typed in the string of characters for a command, 
there are two ways to delete the error. The operator may backspace one 
character at a time by entering CTRLH on the console keyboard until he has 
backspaced past the error and then resume normal entry; the carriage skips 
one line so that the correction may be easily read. If the entire input string 
is in error, the command may be omitted by entering a RUBOUT character 
and starting the command again. 


If several corrections are made in one command and the printing appears in 
several horizontal lines, the operator may view an entire line by entering 


CTRLWN onthe keyboard. At this point, the entire line is printed and further 
action may occur as required. 


5.5 COMMANDS 


Available commands for the operator communications functions allow the op- 
erator to display memory, display job or system information, and start or 
cancel programs. Descriptions of the commands and examples of their use 
are included in Section VI. 


5.6 BATCH SUBSYSTEMS 


Any batch subsystem (BIR, BIS, or BOS) may be started at any time from the 
operator's console. This is accomplished by the operator commands 


//JOB... 
and 
//RUN ... 


Refer to the DX980 General Purpose Operating System Programmer's Guide 
for more detailed descriptions of the Job Control sequences required. 


Typically, once a batch subsystem is started, it remains in memory for a 
relatively long time. The subsystems are terminated by the //CANCEL 
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command. The operator should start the batch subsystems when no other 
jobs are running, in order to use memory most efficiently. 


BIS and BIR are completely autonomous; there are no operator commands 
for these subsystems. BOS does have an operator command, which is dis- 
cussed in Section VI. 


BIR requires the assignment of LUN 10toacard reader. BIS requires the 
assignment of LUN 5 toa card reader. When these are executed using the 

RUN command, the assigned input peripheral device becomes the Batch In- 
put Device. 


BOS requires the assignment of LUN 5 to an output peripheral device, typi- 
cally a line printer, and LUN 6 to an input file. LUN 6 is a "newsflash" 
input LUN - the assigned file is to contain pertinent data of interest to all 
users ata particular installation and is printed on the output peripheral de- 
vice ahead of user data, The 'newsflash'" file must be a linked- sequential 
file, with a logical record length of 80 characters, 
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OPERATOR COMMUNICATIONS COMMANDS AND PRINTED OUTPUTS 


SECTION VI 


6.1 INTRODUCTION 


This section presents programming information for certain input/output op- 
erations using the operator communications package. Included are descrip- 
tions of operator commands, messages printed by the control console that 
are not a result of operator input, and examples of listings generated by the 
commands. 


6.2 AVAILABLE COMMANDS 


The available commands permit the operator to perform the following: 


e Display main and disc memory. 
e Display job or system statistics. 
e Display or modify system time and date. 


e Start or cancel programs using the job management facilities. 


6.2.1 COMMAND MNEMONICS, FUNCTIONS AND FORMATS 


The command mnemonics, functions and input formats are shown in table 6-1. 
Note that the input operands indicated in the formats must be entered exactly 
as shown; this precludes error messages and incorrect DX980 actions. 


The JOB and RUN commands use the same processor modules as does the 
batch input system, and require the same input operands. The CANCEL 
command is invoked by job number. If the job name is known, but not the job 
number, the STATUS command may be used to obtain a cross-reference. 


6.2.2 EXAMPLES OF USE 


The following examples show the use of the various operator communications 
commands. In these examples, (ESC) indicates an Escape control character 
typed on the control console keyboard and (CR) indicates a carriage return. 


e Example 1. Change systems time to 11:59:15 and enter appropriate 
comment. 


a. (ESC) 
//TIME 11, 59, 15, CHANGE TIME (CR) 
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Table 6-1. 


Operator Communication Commands 


Mnemonic Function Format 


ONLINE 


OF F LINE 


, STATUS 


STATUS 


DATE 


DATE 
TIME 


TIME 
REPLY 


JOB 


JOB 


RUN 


CANCEL 


SYSTAT 


Display main memory 


Display disc memory 


Bring device online 


Take device offline 


Display statistics for 
steps in a specified job 


Display statistics for 
all jobs in system 


Modify system date 


Display system date 
Modify system time (24 hr) 


Display system time 


Reply to a system query 
for a task 


Enter setup information 
to run a job from the 
console 

Display job setup informa- 
tion already entered 


Enter a job into the system 
from the console 


Cancel a job in the system 
by job number 


Display Procedure Pool in- 
formation 


DMEM 


DDISC 


ONLINE 


OF F LINE 


STATUS 


STATUS 


DATE 


DATE 
TIME 


TIME 
REPLY 


JOB 


JOB. 


RUN 


start addr 
end addr 


disc drive no. 
start sector addr 


end sector addr 


device mne- 
monic 


device: mne- 
monic 
job no. 


(none) 


month day 
year 


hours minutes 


seconds 

(none) 

message ID {YES 
NO 

(Same as batch 

input)* 

(none) 


(Same as batch 
input)* 


CANCEL job number 


SYSTAT 


(none) 


*Refer to description of Job Control Language in DX980 General Purpose 


Operating System Programmer's Guide, Manual No. 943005-9701. 
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b. (ESC) 


//TIME 11; (CR) ..59; (CR) ..15; CHANGE TIME (CR) 


c. (ESC) 
//TIME 11 59 15 (CR) 


Example 2. Request STATUS of all programs in the system. 


(ESC) 
//STATUS (CR) 


Example 3. Display memory from location 1000 for 512 words. 


a. (ESC) 
//DMEM 1000 1512 (CR) 


b. (ESC) 


Change 1 


//DMEM >3E8 >5E8 (CR) 
c. (ESC) 


//DMEM ™BE8;(CR)SE8. COMMENT (CR) 


Example 4. Start JCL franslator from the console. 


(ESC) 
//JOB JCLTRN USEROI 
(ESC) 


//RUN JCL DSRC=SC DLST=DUMMYyY; (CR). . DERR=SC 


DOBJ=DISC1; (CR) .. FOBJ=(SYSTEM 


) (CR) 


Example 5. Cancel job by number (for this example job number = 2), 


(ESC) 

//STATUS. FIND NUMBER (CR) 
(ESC) 

//CANCEL 2. (CR) 
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6 Example 6. Operator reply to a message from DX980, informing 
him that a needed line printer is offline. 


DEVICE LP1 JOB-NO 5 JOB-NAME XXX NOT READY 
REPLY YES OR NO WITH MESSAGE ID = 377 


(ESC) 
//REPLY 377 YES 
6.2.3 BATCH OUTPUT SPOOLER (BOS) COMMAND 


If the Batch Output Spooler has been activated, the operator has another com- 
mand in his set, BOS, which he may use to control the listing of the spooled 
output. The three options of this command are as follows: 


a. (ESC) 
//BOSKBCANCEL (CR) 


This causes printing of the currently active data set to terminate, 
and printing of the next data set in'the spool file to commence. 


b. (ESC) 
//BOS#PRESTART (CR) 


As the name RESTART implies, this option of the command causes 
repositioning to the beginning of the current data set. 


c. (ESC) 
//BOS#SKIP<nn > (CR) 


The integer <nn>represents the number of lines by which the file is 
to be repositioned. The integer may be positive (reposition ahead) 
or negative (reposition backwards). For instance, <nn>= 10 means 
skip the next ten lines of print;<nn>= -10 means reprint the last 
ten lines. The positioning is relative to the line being printed when 
the Batch Output Spooler acts on the received BOS command. 


Backspacing a number of lines greater than the number already printed from 
the data set using the SKIP option is equivalent to the RESTART option; sim. 
ilarly, requesting a skip ahead for more lines than the number iemeiing 

to be printed is equivalent to the CANCEL option. 


6.3 UNSOLICITED MESSAGES 


The operator may see five categories of unsolicited messages appearing on 
the control console printout. These message categories are described in the 


following paragraphs. 


a eee ae EI nea 5 a a ee eT 
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1 SUBMISSION 


Upon receipt of a newly submitted job by the Job Management modules, an 


acknowledgement message is sent to the console. 


message is: 


NO, =4 


UID= SYSTEM NAME=S 


An example of this type of 


SUBMITTED 


where NO. is the job number, UID is the user ID, and NAME is the job name. 
The message is informational, and no action is required. 


63.3% 


2 TERMINATION 


Messages referring to the termination of both jobs and steps may be printed 
by the control console. 


tion, including a code indicating the cause of the termination. 


The step termination messages carry more informa- 


An example of 


a step termination message is: 


The 


NO. =3 
TERM CODE=0 


UID= SYSTEM NAME=LNKCLG STEP=1 
TASK TIME=0 0 21 101 


TERMINATED AT 02D3 
MJAR=7914 MJEA=1059 EX=7048 


parameters in this message have the following meanings: 


NO. 

UID 

NAME 

STEP 
TERMINATED AT 


TASK TIME 


MJAR 
MJEA 
EX 


Job number 
User ID 

Job name 
Step number 


Exit relative address - of interest if termination 
was not normal 


that is uai to 0 if termination was-normal, 
and is not equal to 0 otherwise; see the appendixes 
of the DX980 General Purpose Operating System 
Programmer's Guide. for the meaning of termina- 
tion codes, Error codes greater than 10,000 are 


generated by user programs via SVC 4, 

Time in hours, minutes, seconds, and millisec- 
onds 

User program size - actual, instead of requested 
Actual job extension area (JEA) memory space used 


Excess memory space requested - user area plus 
JEA 
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The step termination message is informational and does not require operator 
action. If the termination code is nonzero, however, the programmer re- 
sponsible for the job should be informed. 


Certain other error messages may be given with the step termination mes- 
sage. There are three formats for these messages as follows: 


ERROR ID= This message gives the device name or 
file name to which the TERM CODE 
applies (if applicable. ) 


ERROR CODE=59 ERROR ID= This message gives the device name or 
file name for each logical unit number 
for which the user program failed to do | 
a Close I/O call. (Maximum of 6 names 
given.) (Not given if the operator can- 
cels the job. ) 


ERROR # /ERROR ID= This message gives the error number 
and corresponding device name or file 
name if any errors are detected by Job 
Management after the job step termi- 
nates. (Maximum of 3 names given. ) 
An example of such an error is specify- 
ing Delete on a file without giving the 
proper password. Meanings of the 
error numbers are given in Appendix A 


of the DX980 General Purpose Operating 


System Programmer's Guide, Part Num- 
ber 943005-9701. 


If *MJAR appears in the message instead of MJAR, the program uses mem- 
ory space beyond the physical end of the load module. 


An abbreviated termination message is printed if a ready job which was in 
the JCBFIL is cancelled. 


The format of the message is as follows: 
NOgss TERM CODE = nnnn 
where nnnn is the termination error number. 


The job termination message informs the operator that all steps within the 
job have finished. An example is: 


STRING NO.=5 TERMINATED 
where STRING NO. is the job number. 
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6.3.3 INTERVENTION REQUEST 


The intervention request message informs the operator that a device required 
by the active job is offline, has timed out, run out of paper, or is otherwise 
in need of an operator action, When the operator receives an intervention 
request he must: 


1, Correct the specified problem or determine that it is not correctable. 


2. Enter a REPLY command that has the first operand equal to the mes- 
sage ID and the second operand equal to either YES or NO, 


For example, the following message from a card reader indicates a data 
error: 


DEVICE CRI JOB-NO 31 JOB-NAME E DATA ERROR 
REPLY YES OR NO WITH MESSAGE ID = 24574 


To respond to this message, the operator must: 


1. Put the last card read back in the card reader to be read as the 
next card, 


2. Ready the card reader, 
3. Press CTRL and O simultaneously, 
4 


Press the ESC key; 


ff SNS > wee Be eee a = x vy oo 


5. Enter the following: 
REPLY 24574 YES 
followed by a carriage return, 
Similarly, the following message from a line printer: 


DEVICE LPI JOB-NO 29 JOB-NAME JCLBIR OFFLINE 
REPLY YES OR NO WITH MESSAGE ID = 24550 


requires the following actions from the operator: 
1, Ready the printer 
2. Press CTRL and O simultaneously 


“ {D0 se ee on Peet ’ 

S yA. Sc ae menses aie a Abe ¥’ et ‘| 
‘i x Lin } “ p 

(4 rf fet K.. 


Ee Beso Yes 


Change 1 6-6A/6-6B Digital Systems Division 


° 
WH 943004-9701 


3. Press the ESC key; the system responds with // 
4, Enter the following: 
ONLINE LP1 
The console responds with: 
ONLINE COMPLETE 
5. Press the ESC key; the system responds with // 
6, Enter the following: 
REPLY 24550 YES 
followed by a carriage return. 
Finally, the following message from a card reader: 


DEVICE CRI JOB-NO 7 JOB-NAME JCLBIS NOT READY 
REPLY YES OR NO WITH MESSAGE ID = 24574 


requires the following actions from the operator: 
1, Ready the card reader 
2. Press CTRL and O simultaneously 
3. Press the ESC key; the system responds with // 
4, Enter the following: 
REPLY 24574 YES 


followed by a carriage return. 


6.3.4 OPERATOR COMMUNICATIONS ERROR MESSAGES 


If an entry made by the operator is incorrectly formatted or otherwise in- 
valid, a message with the following format will appear: 


OCM - <nnn> 
where <nnn>is an error code. 
The meaning of a specific code, and the action to correct it, is found in 
Appendix A, 
6.3.5 MESSAGES FROM UTILITIES 


Several systems programs, such as the link editor, send messages to the 
console. The text of these should be self-explanatory, for example: 


READY INPUT, HIT C/R 


If there is any doubt about the required action to be taken, refer to the dis- 


cussion of the particular utility in the DX980 General Purpose Operating 


System Programmer's Guide. 
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6.4 EXAMPLE LISTINGS 


The following paragraphs present examples of listings generated by com- 
mands and the messages printed in response to the commands. Explanations 
of the listings are included. 


6.4.1 OUTPUT OF STATUS COMMAND 


The output of the STATUS command is obtained by entering the following on 
the control console keyboard: 


(ESC) 
//STATUS 


followed by a carriage return. A display is printed out in the format shown 


in figure 6-1. 


The parameters shown in the listing in figure 6-1 have the following meanings; 


JOBNAM Job name 

JOBNUM Job number 

STATE Running, ready or rolling status of program 

PRI Priority number 

PRV Privileged job (Y), or non-privileged (user) job (N) 

LL Starting address of program area 

EX Ending address of program area, or the starting address 
of the Job Extension Area minus 1. For DX980, the field 
refers to the present boundaries of the DSCA. 

UL Ending address of Job Extension Area. For DX980, the 
field refers to the present boundaries of the DSCA. 

TIME USED Length of time the program has been running, in seconds 
and milliseconds of CPU time 

STEP Step number of program within job 

JIGEMAM..JOENLIM. STATE... ee PRI. .PRV...LL....EX....UL...TIME LISED... STEP. 

DNS t RUNING a iT: Oo00 4F44q4 e524 2 3 1 

Fo] 3 RUNHING N eset Ch2e9 Cres 6 35 1 

FTN 5 READY 1 

FTN 5 PEADY 5 

FTN oa) READY 4 

FTN 5 READY 3 

FTN g, READY 2 

> 2 ROLLED 29 N eres Cheo Creo 0 350 1 


ENT OF DISPLAY 


Figure 6-1. 


STATUS Command Output Listing 
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In the example in figure 6-1, job S started running, but was rolled out by job 
B after using about a third of a second of CPU time. Bis a one-step job. 
When B terminates, S will roll back in or job FTN (a FORTRAN compile, link 
and go) will begin running, or both at the same time, depending on the priority 
of FTN and its memory size requirement. 


Since FTN has not started running (the STATE is READY), it has not yet been 
assigned a memory area, and has not used CPU time. 
6.4.2 OUTPUT OF JOB COMMAND 


Entering the JOB command on the control console keyboard without an oper- 
and causes a listing of current JOB information to be printed, in the format 
of the following example: 


//JOB 
SAMPLE USEROI1 FILE=SJCBFL DEV=1 DIR=SYSTEM 


PSW=NONE 


In this example, the parameters have the following meanings: 


SAMPLE A specific job name 

USERO1 A specific user ID 

FILE Residence of the JCL 

DEV Disc containing the file 

DIR Directory 

PSW Password: NONE if there is no password, **** if one is 
present. 


6.4.3 ONLINE, OFFLINE AND CANCEL MESSAGES 


When an ONLINE, OFFLINE or CANCEL command is issued, the request is 
acknowledged when it is serviced. Examples of the commands and messages 
follow: 


//ONLINE LP1 
ONLINE COMPLETE 


//OFFLINE LP1 
OFFLINE COMPLETE 


//CA 4 
JOB NUMBER 4 CANCELLED 
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If a device is in use at the time of an OF FLINE request, the action is delayed 
until completion, and the following is printed by the console: 


//OFFLINE CRl 
OFF LINE IN PROGRESS 
6.4.4 DMEM DISPLAY 
The DMEM display has the format shown in the example in figure 6-2. 


The right-hand portion of figure 6-2 is a character dump. Unprintable char- 
acters are represented by dots in this dump. 


If only the first operand is input, the default display length is specified. The 
default length is eight words (a one-line display). 


“/DMEM > 1000 1040 


1000 = OFOS CNEL 82315 FOS CNEL S916 825 2317. PE Stee e a = ey cee 
102 = mEe2S 28998 O822 S919 O821 SStR OSOR S3ik Be eee evan eens 
Wink = OFOS ner S910 oFor TOEL Saib OFOS Snel ee eravete Mecca’ R) 

1018 = BALE GENE S910 #1F10 CHEF Foti OFOO S905 ....20-- Paina we 
1020 = CDAN Fane OS03 DEAS ||809 A7Ne Bios Fsen M oe CEs cee cee oes 
ti2Q= Nts 1602 1037 1098 1079 103 10938 1F18 Pde o¥ eee Ss S68 ois 
1020 = 18FR Fane Biot cS1i6 CSNF 1ES5 O198 OO Ses kh era 
1e2s = OOOO D1 OO8e4 FONG OOLF 6529 Seer Crbs Seow beerw ete 8% »..56 
O40 = Einar anec C550 C551 ASI4 1014 C536 OLOF 1.s sEPEL$.. «E65 


Figure 6-2. DMEM Display Format Example 


6.4.5 DATE AND TIME 
The DATE and TIME displays appear as in the following examples: 


//DATE 
DATE= 1/1/74 


//TIME 
TIME = 0: 16: 52 


The time in the TIME display is given on a 24-hour basis, so that the example 
printout shows about 17 minutes after midnight. 


6.4.6 OUTPUT OF SYSTAT COMMAND 
The SYSTAT display has the format shown in the following example: 


//SYSTAT 
NL=130 R=2 MAXDSCA=1946 


where NL is the number of SVC loads actually performed by the Procedure 
Pool Manager, R is the ratio of the number of SVC requests to the number of 
SVC's actually loaded (truncated to the nearest integer), and MAXDSCA is 
the maximum DSCA memory space used to this point in the program. 
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After the display is sent, the NL counter is reset to zero, so that each 
SYSTAT request shows what has happened since the prior request. The 
MAXDSCA counter is not reset, and reflects the maximum memory space 
used since the last IPL. 
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APPENDIX A 
OPERATOR COMMUNICATIONS ERROR CODES 


A.1 GENERAL 


This appendix includes a list of error codes for the errors most frequently 
encountered by operators. Error codes 95 through 99 are errors in JOB and 
RUN commands, and error codes 101 through 112 are error indications that 
come directly from the operator communications modules. 


Error codes between 400 and 536 may appear occasionally; they indicate 
problems in the JCL scanning processes and may reflect bad JCL templates; 
if a retry does not correct the error, refer the problem to the programmer 
in charge. 


Error Codes greater than 10, 000 are generated by user programs through 
SVC 4. The meanings of error codes that can appear may be found in the 
DX980 General Purpose Operating System Programmer's Guide, 


A.2 MEANINGS OF ERROR CODES 


The meanings of the error codes most often encountered by operators and 
the corrective actions to be taken are listed in table A-l. 


Table A-1. Operator Communications Error Codes 


Correct and retry. 


User ID specified for proce- 
el 


dure library is missp 


does not exist. 


96 User ID is valid but does not Correct and retry. 
have a procedure library of the 
specified name, 


97 Integrity code violation on li- Correct and retry, or return 
brary access. message to responsible pro- 
grammer. 
98 User ID and procedure library Correct and retry, or inform 
exist, but requested procedure responsible programmer. 
does not. 


Hardware failure while attempt- | If retry fails, call field service 
ing read of library. representative. 


Hardware I/O error. If retry fails, call field service 
representative. 
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Table A-1, Operator Communications Error Codes (Continued) 


A REPLY command was sent Correct and retry. 
where none was expected, or 

REPLY contained wrong mes- 

sage ID. | 


Invalid operand in command, Correct and retry. 
May indicate wrong number of 

operands, or misspelled oper- 

and, or characters instead of 

integers. 


Invalid argument list, May in- | Correct and retry. 
dicate any of the problems 

given for code 103, or no op- 

erands where operands were 

required, 


Invalid job number where op- Correct and retry. 
erand expected a job number; 

or an attempt to cancel 

DX980. 


Attempt was made to OF FLINE|Do not retry. 
the system disc or the system 
console, 


No space in the DSCA If other jobs are in system, wait 
for a job to terminate; otherwise, 
re-IPL and increase DSCA size, 


Command invalid or mis- Retry, with full command or 
spelled. first two letters of command, 


Job number not found, Correct and retry; enter STATUS 
without operands to check data, 


In a Job step, JSB size is Refer to programmer in charge, 
too large (>800 words). 


The integer <nn>in Correct and retry. 
BOS#SKIPb<nn> is missing or 
mistyped, or otherwise invalid. 


Operand <xxx> in BOSb<xxx> Only RESTART, CANCEL and 
is invalid. SKIP#<nn> are valid here, 
Retry. 
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SYSTEM FAILURE (SCRASH) CODES 


APPENDIX B 


B.1 GENERAL 


If the CPU goes into a hard idle (front panel IDLE indicator remains lit), dis- 
play the contents of the Instruction Register (IR). If the value is CE01 6 or 
CEOF 16, a system failure has occurred. Display the contents of the A regis- 
ter on the computer front panel, and use this value to determine the cause of 
the failure from table B-1. The code in the second column of the table indi- 
cates the action to be taken by the operator. 


B.2 OPERATOR ACTION CODES 
The meanings of the codes in the second column of table B-1 are as follows: 


B There is a bug in the software. Send a Software Trouble Report 
(STR). 


C The probiem can be corrected by the user. For example, a Proced- 
ure Pool failure (A = 0001) ¢) should indicate a re-execution of IPL 
with an increase in the Procedure Pool size. 


I Restart the system. The problem should not recur, but if it does, 
send a Software Trouble Report (STR), 


N The problem is not correctable. Generally, it is a hardware pro- 
blem; call a field service representative. 


R Rebuild system. 


Operator action codes not marked in the second column are those that had 
never been observed when this manual was published. 


Table B-1. System Failure Codes 


A Register Operator Spee 
(Hexadecimal) Action 8 


C Unable to find room in Procedure Pool. 


Error code returned from SLOADR., 
Second argument: 

0002,¢ DSCA too small. 

00OEC)¢ Hardware disc error on system disc. 


0003 Second argument: 
C 0001li¢ DSCA too small. 
C 0002,¢ TCB too small for newly created task 
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Table B-1. System Failure Codes (Continued) 


A Register Operator 
(Hexadecimal) Action 


Meaning 


Unable to find LDT for LUN 255 


Supervisor memory parity error: 
(E Register) = Address of error. 
(X Register) = Status. 


Attempted to cancel DX980 system job. 


I/O error when writing Master File Direc- 
tory (MFD). 


Second argument: 
000016 No PDT designated as system console. 
000114 Error on create task; DSCA too small. 
000216 Error on create task; TCB too small 


Invalid status from controller. 
Disc busy. 

Invalid head number. 

No space in DSCA. 


No system Job Management task for job num- 
ber. 


TE NHIB = 0 at entry. 
TEFNHIB # 1 at entry. 
Error from task suspend. 


Unable to find or open UFD during file de- 
assignment. 

Unable to find PDT for device during deassign- 
ment. 


Attempt to delink MFD FCB. 
Reserved 

Reserved 

Delete file error. 


TENHIB # 1 on entry. 


Error on definition of JSB file,. 
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Table B-1. System Failure Codes (Continued) 


A Register Operator 
(Hexadecimal) Action 


Meaning 


Tried to write JSB to JSB file and failed. 
Error on definition of JSB file, 
Resource in PCB not in PDT-FCB links. 


Reserved 


001C - Kither invalid file type or track zero bad. 
| | 
| | 
| | 
| | 
001D - | Error while attempting to ASSIGN to the SOQ 
| | file. Look at argument. (It is the error re- 
turned from attempting the dynamic ASSIGN. ) 
0O1LE B Could not find (SFIND) the ''CCB" for a ready 
JOB upon cancellation. 
| 001F - Delete entry on SOQ file upon program error. 
| 0020 R Track zero bad status. 
0021 I | Could not open current User File Directory. 
| 
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Table B-l. 


System Failure Codes (Continued) 


Operator : 


Received error. Check second parameter. 


Received integrity code violation when attempt- 
ing to delete a file under a user. 


Reserved 
Reserved 


Reserved 


Could not open the UFD, check the second 
parameter. 


Unable to open the UFD. 


Disc error while releasing temporary files. 
‘Second parameter contains error number, 


Power failure. 
(X Register) = Status. 
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Table B-1. System Failure Codes (Continued) 


A Register Operator ? 

, ‘ Meaning 
(Hexadecimal) Action 

NOTE 


For the failure codes that follow, the In. 
struction Register contents is CE01,¢.* 


FFCO Unserviceable data bus interrupt. 
(E Register) = Internal data bus interrupt ex- 
pander. 

FFCI Unserviceable DMAC interrupt. 


(E Register) = DMAC status word. 


Unserviceable vectored interrupt. 
(X Register) = interrupt level 


*If the START switch is momentarily set to the START (down) position, 
normal processing should continue. 


B.3 SECOND ARGUMENTS 


Some of the error codes require that the operator determine the value of a 
second argument in addition to the error code. To find the second argument, 
proceed as follows: 


1. Display the contents of the M register by momentarily setting the M 
switch on the computer front panel to the DISPLAY (down) position. 


2. The next three steps will display the memory word at the address 
given by the location two words higher than the address in the M 
register. Set the data switches to the value of the address contain- 
ing the memory word to be displayed. 


3. Momentarily set the MA switch to the ENTER (up) position. 
4, Momentarily set the MD switch to the DISPLAY (down) position. 


If it is necessary to send an STR to report a software problem, include all 
available information. The memory addresses and words in the procedure 
above should be part of this information. 
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APPENDIX C 


REQUIRED SETTINGS FOR HARDWARE 


C.l INTERVAL TIMER SWITCH SETTINGS 


A seven-element switch on the Interval Timer circuit board is used to select 
the timer resolution intervals (the period between decrement pulses to the 
counter) and the external register address, All seven pencil switch positions 
should be off except position no. 4, the l-millisecond resolution interval. 
The resolution intervals are marked adjacent to the pencil switch positions, 
Setting the two switch positions for the external register address to Off se- 
lects the standard address, 


C.2 COMMUNICATIONS MODULE SWITCH SETTINGS 


To get output from IPL using a minimum hardware configuration (system 
console is a 733 ASR assigned to Register 5), the Communications Module 
switches must be set as follows: 


Switch 1: Poles 1, 2, 3, 4 and 6 set to the ON position; 
Poles 5 and 7 set to the Off position, 


Switch 2: ty es 1, 2, 4, 5 and 7 set to the ON p 


Ss 
es 3 and 6 set to the Off position. 
Refer to the Model 980 Series Computer Programming Card, Publication No, 


943000-9701, for Communications Module switch settings to drive other de- 
vices, 


C.3 I/O CARD SLOT LOCATIONS 


The DX980 software operating system requires I/O cards to occupy specific 
I/O slot positions. When 980 systems that run DX980 are installed or ser- 
viced, the I/O card position must be maintained. 


All 980 1/0 card addresses are a function of wiring (or switches) on the inter- 
face card itself, Software that is not interrupt-driven (such as the Basic Op- 
erating System and most data bus device Performance Demonstration Tests) 
may address a specific external register, and the I/O card that is configured 
for this address responds regardless of its slot position in the chassis, 
Interrupt-driven software (such as DX980) addresses I/O cards by the same 
procedure, but uses the data bus interrupt capability of the interface, Data 
bus interrupts depend on I/O slot position, The software determines which 
device needs service by reading the data bus interrupt expander word (ex- 
ternal register 13)¢). Nonzero bits of this 16-bit word (bits 0-15) indicate 
interrupts from the card in the slot corresponding to the bit number, 
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If a DX980 system successfully completes all Performance Demonstration 
Tests but fails to print 


*READY 


when a DX980 system is loaded, the improper I/O card configuration is 
identified by the following procedure, When an unrecognizable data bus inter- 
rupt is received by DX980 software, the CPU idles, The instruction register 
contains CE01l,¢, the A register contains FFC0 )¢, and the E register con- 
tains the data bus interrupt expander word. Check which bit positions are 

1's in this word to see which I/O slot positions are interrupting. To deter- 
mine the proper I/O card configuration for a DX980 system, one of two pro- 
cedures must be followed, One procedure makes use of a system table; the 
other makes use of an IPL program display. 


C.3.1 SYSTEM TABLE 


A System Table (an assembly language listing) was delivered with the earlier 
DX980 systems, If this table is available for the specific system, find the 
data bus PDT address table at label ITDBTO. The 13 Data statements in 
this table correspond to the 13 I/O ports available in the CPU chassis. A 
zero entry in a given position indicates that the corresponding I/O card slot 
should be unoccupied, If the Data statement contains a nonzero value, the 
device that should occupy the corresponding slot can be determined from the 
operand field of the Data statement. This field contains a name (such as 
ITPDT) which is the pointer to the Physical Device Table for the device, 
Find this label in the listing. 


The comments directly above the label indicate the type of I/O card required 
(Interval Timer Module, for example). . 
C.3.2 IPL PROGRAM DISPLAY 


The IPL (Initial Program Load) program that is shipped with more recent 
systems displays the I/O slot configuration by use of the List Devices com- 
mand as shown below, | 
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The Keyname, Device Name, and Expansion Number-Slot priority columns 
above indicate an interval timer card shouid be in slot 102, a communications 
module for the data terminal system console in slot 103, Note that the port 
number for DMAC devices is also indicated in this table. 
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